List dispositions

GET

/api/v1/dispositions

curl --request GET \
  --url 'https://api.inside.chat/api/v1/dispositions?website_id=example' \
  --header 'Authorization: Bearer <token>'

• Hosted Gateway
• Local development

Required scopes: conversation_read
Data access: –
MCP tool: dispositions

List the website disposition catalogue. Requires an unrestricted installation policy.

Authorizations

• installation_token
• oauth_client_credentials
  conversation_read

Parameters

Query Parameters

website_id

required

string

/^web_[0-9]{1,20}_[1-9][0-9]{0,18}$/

An explicitly granted website.

language

string

Responses

200

Authorized result. Projection depends on current scopes and data policy.

Media typeapplication/json

The configured disposition catalogue, localised to language when available.

object

data

required

object

language

required

string

dispositions

required

Array<object>

object

id

required

string

label

string

disposition

required

The value to send to conversation_disposition_set.

string

category_name

string

description

Any of:

string

string

null

null

Example ^generated

{
  "data": {
    "language": "example",
    "dispositions": [
      {
        "id": "example",
        "label": "example",
        "disposition": "example",
        "category_name": "example",
        "description": "example"
      }
    ]
  }
}

400

Invalid, duplicate or unsupported request parameters.

401

Missing, expired or revoked installation credential.

404

Resource not found or not permitted by current authority.

422

The requested capability is not available for application installations.

429

Per-app quota exceeded.

Headers

Retry-After

integer

>= 1

503

Enrollment, native service or required authority is unavailable.