channels

Connect a Slack channel

Verifies a Slack Incoming Webhook by posting a confirmation message, then stores the webhook URL encrypted for the workspace.

post/api/v1/channels/connect/slack

Request

Base URL: https://api.cadencz.com (the document declares no server; this is the origin it was published from)
URL: https://api.cadencz.com/api/v1/channels/connect/slack
Auth: HTTP bearer

Request body

webhook_urlstring required

Slack Incoming Webhook URL (https://hooks.slack.com/services/…).

display_namestring nullable

Optional label for the channel.

Example request

{
  "webhook_url": "https://hooks.slack.com/services/T000/B000/XXXX",
  "display_name": "#launches"
}

Response

Successful Response

idstring required

workspace_idstring required

platformstring required

handlestring required

display_namestring nullable required

avatar_urlstring nullable required

statusstring required

byo_appboolean required

token_expires_atstring date-time nullable required

followersinteger required

capabilitiesobject

plan_entitledboolean

entitlement_status'available' | 'plan_paused' | 'disconnected'

plan_pause_reason'plan_required' | 'workspace_limit' | 'platform_limit' nullable

Example response

{
  "avatar_url": "https://example.com/avatar.png",
  "byo_app": false,
  "display_name": "Cadencz",
  "followers": 42,
  "handle": "cadencz.bsky.social",
  "id": "chn_123",
  "platform": "bluesky",
  "status": "connected",
  "workspace_id": "wks_123"
}

Changes

No recorded changes to this operation across all 1 revision of this API.