Skip to main content
POST
/
apps
/
install
Install an app
curl --request POST \
  --url https://apps-studio.thena.ai/apps/install \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "teamIds": [
    "TGCA9557W4",
    "TGCA9557W5"
  ],
  "appId": "9FKHF3KJ10JQTR2YJ6QW1QZTHBZ85",
  "appConfiguration": {
    "required_settings": [
      "check the app manifest for required_settings schema"
    ],
    "optional_settings": [
      "check the app manifest for optional_settings schema"
    ]
  }
}'
{
  "appName": "Thena.ai",
  "botSub": "OGGA0557MV",
  "botTokenKey": "pk_live_*******_*******",
  "botToken": "pk_live_*******_*******",
  "installedBySub": "UGGA0557MV",
  "installedByEmail": "[email protected]",
  "appInstalledForTeams": [
    "TGGA0557MV",
    "TGGA0557MV"
  ],
  "appIdentifier": "thena-ai",
  "installedByOrgId": "OGGA0557MV",
  "metadata": {
    "app_identifier": "thena-ai",
    "app_name": "Thena.ai",
    "app_description": "Thena.ai is a platform for creating and managing AI agents.",
    "app_version": "1.0.0",
    "app_author": "Thena.ai",
    "app_author_email": "[email protected]",
    "app_author_url": "https://thena.ai"
  }
}

Authorizations

x-api-key
string
header
required

Body

application/json
teamIds
string[]
required
Example:
appId
string
required
Example:
appConfiguration
object
required

Response

appName
string
required
Example:
botSub
string
required
Example:
botTokenKey
string
required
Example:
botToken
string
required
Example:
installedBySub
string
required
Example:
installedByEmail
string
required
Example:
appInstalledForTeams
string[]
required
Example:
appIdentifier
string
required
Example:
installedByOrgId
string
required
Example:
metadata
object
required
Example: