List channels

GET

/api/v1/channels

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

• Hosted Gateway
• Local development

Required scopes: live_read
Data access: –
MCP tool: channels

List the website’s permitted channels.

Authorizations

• installation_token
• oauth_client_credentials
  live_read

Parameters

Query Parameters

website_id

required

string

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

An explicitly granted website.

Responses

200

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

Media typeapplication/json

Channels visible to this installation. Channel restrictions apply.

object

data

required

object

channels

required

Array<object>

object

id

required

string

/^chn_/

name

required

Any of:

string

string

null

null

Example ^generated

{
  "data": {
    "channels": [
      {
        "id": "example",
        "name": "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.