The App Provision Object

The app_provision object contains the general setting information of one of your Space extensions. To access this seeing information, use the OAuth token provided. With the OAuth token, your extension can send a request to retrieve the general setting information to the app_provisions endpoint. Outside of the app, you can also use your personal access token.

You can find more information on how to get your OAuth token on our OAuth 2.0 Authorization Flow documentation. We mentioned an important endpoint, app_provisions and you can check examples in this section of our documentation.

To generate a personal access token, you can do that from My Account → Account Settings → Personal access token.

Properties

public_config
string

Public configurations
session
string

Status of the session
slug
string

The slug specific to this Space Plugin or Tool Plugin
extension_id
number

Space Plugin or Tool Plugin id
name
string

Space Plugin or Tool Plugin name
in_sidebar
boolean

A status in the sidebar if your plugin is a space app
in_toolbar
boolean

A status in the toolbar if your plugin is tool plugin
sidebar_icon
string

Your space app sidebar icon image path
enable_space_settings
boolean

A status to show whether your extension is enabled for space level settings or not
space_level_settings
object

Space level settings

Example Object

{
  "app_provision": {
    "public_config": null,
    "session": null,
    "slug": "my-first-plugin",
    "app_id": 12345,
    "name": "My first plugin",
    "in_sidebar": true,
    "in_toolbar": false,
    "sidebar_icon": null,
    "enable_space_settings": true,
    "space_level_settings": {}
  },
  "granted": false
}

Prev The Extension Object

Next Retrieve Settings of an Installed Extension