Get Slack Status

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

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

GET

agent

{id}

slack

status

Get Slack Status

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

{
  "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.

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

boolean

required

Whether a Slack account is currently linked to the agent

string

Slack user ID (only present if linked)

string

Slack workspace/team ID (only present if linked)

string

Slack username (only present if linked)

string

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

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

Generate Slack Link Code Unlink Slack Account

Overview

Authentication

AI Agents

Agent Messaging

Agent Schedules & Triggers

Agent Channels

Agent Filesystem

MCP Servers

Spotlight

Tokens

Provider Keys

Telemetry

Get Slack Status

Authentication

Example Request

Example Response

Linked Account

Not Linked

Response Fields

Status Codes

​Authentication

​Example Request

​Example Response

​Linked Account

​Not Linked

​Response Fields

​Status Codes

Authentication

Example Request

Example Response

Linked Account

Not Linked

Response Fields

Status Codes