List Channel Bindings

List all active channel bindings for an agent.

GET /v1/agent/{id}/channels

List Channel Bindings

cURL

curl --request GET \
  --url https://api.app.shinzo.ai/v1/agent/{id}/channels \
  --header 'Authorization: Bearer <token>'

Authentication

Requires JWT token or Platform API key via Authorization: Bearer <token> header.

id · string · required

Agent UUID

Example Request

curl -X GET https://api.app.shinzo.ai/v1/agent/a1b2c3d4-e5f6-7890-abcd-ef1234567890/channels \
  -H "Authorization: Bearer <token>"

Example Response

{
  "bindings": [
    {
      "id": "bind_abc123",
      "channel": "api",
      "status": "active",
      "created_at": "2025-01-15T10:00:00Z"
    },
    {
      "id": "bind_def456",
      "channel": "discord",
      "status": "active",
      "discord_user_id": "123456789012345678",
      "discord_username": "myuser#1234",
      "created_at": "2025-01-16T12:00:00Z"
    },
    {
      "id": "bind_ghi789",
      "channel": "slack",
      "status": "active",
      "slack_user_id": "U01234ABCDE",
      "slack_username": "john.doe",
      "created_at": "2025-01-17T14:30:00Z"
    },
    {
      "id": "bind_jkl012",
      "channel": "telegram",
      "status": "active",
      "telegram_user_id": "123456789",
      "telegram_username": "johndoe",
      "created_at": "2025-01-18T09:15:00Z"
    }
  ]
}

Status Codes

Code	Description
200	Success
401	Unauthorized - invalid or missing authentication
404	Agent not found