List teams

GET

/api/v1/teams

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

• Hosted Gateway
• Local development

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

List the website’s permitted teams.

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

Teams visible to this installation. Team restrictions apply.

object

data

required

object

teams

required

Array<object>

object

id

required

string

/^team_/

name

required

Any of:

string

string

null

null

Example ^generated

{
  "data": {
    "teams": [
      {
        "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.