Install catalog app into project

POST

/api/api-tokens/{projectId}/catalog/apps/{appId}/install

Request

Authorization

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/api/api-tokens//catalog/apps//install' \
--header 'Accept-Language;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "permissions": [
        "can_view_leads",
        "can_manage_dialogs"
    ],
    "developer_support_permissions": [
        "can_view_agents",
        "can_view_project_variables"
    ]
}'

Response Example

{
    "id": "string",
    "app_id": "string",
    "project_id": "string",
    "installed_by_user_id": "string",
    "granted_permissions": [
        "string"
    ],
    "developer_support_permissions": [
        "string"
    ],
    "installation_status": "active",
    "installed_version": 0,
    "app": {
        "id": "string",
        "name": "string",
        "description": "string",
        "icon_url": "string",
        "website_url": "string",
        "types": [
            "oauth"
        ],
        "publication_status": "private",
        "is_catalog_visible": true,
        "allowed_permissions": [
            "string"
        ],
        "allow_developer_support_access": true,
        "allowed_developer_support_permissions": [
            "string"
        ]
    },
    "can_update_permissions": true,
    "can_uninstall": true,
    "has_setup": true,
    "created_at": "2019-08-24T14:15:22.123Z",
    "updated_at": "2019-08-24T14:15:22.123Z"
}

Modified at 2026-04-17 11:52:11

Get catalog app details in project context

List active app installations in project