The App Provision Object

The app_provision object contains the general setting information of one of your Space extensions. To access this 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.

Tip

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.

Note

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
}