Get Slack Status

Check if a Slack account is linked to an agent and get binding details.

GET /v1/agent/{id}/slack/status

Get Slack Status

cURL

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

200

{
  "linked": true,
  "slack_user_id": "<string>",
  "slack_team_id": "<string>",
  "slack_username": "<string>",
  "linked_at": "<string>",
  "channel_binding_id": "<string>"
}

Authentication

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

id · string · required

Agent UUID

Example Request

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

Example Response

Linked Account

{
  "linked": true,
  "slack_user_id": "U01234ABCDE",
  "slack_team_id": "T01234ABCDE",
  "slack_username": "john_doe",
  "linked_at": "2026-02-20T10:30:00Z",
  "channel_binding_id": "cb-123e4567-e89b-12d3-a456-426614174000"
}

Not Linked

{
  "linked": false
}

Response Fields

linked · boolean · required

Whether a Slack account is currently linked to the agent

slack_user_id · string

Slack user ID (only present if linked)

slack_team_id · string

Slack workspace/team ID (only present if linked)

slack_username · string

Slack username (only present if linked)

linked_at · string

ISO 8601 timestamp of when the account was linked (only present if linked)

channel_binding_id · string

UUID of the channel binding record (only present if linked)

Status Codes

Code	Description
200	Status retrieved successfully
401	Unauthorized - invalid or missing authentication
404	Agent not found