Claim Slack workspace connection

Requires the authenticated user to match the user that started the install, atomically consumes the one-time ticket, and persists the workspace connection. The bot token stays server-held.

post/v1/slack-oauth/claim

Request

Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
URL: /v1/slack-oauth/claim
Auth: HTTP bearer

Request body

sessionstring required

State ticket from the solomon-ai://oauth/slack/done deep link.

Example request

{
  "session": "state_abc123"
}

Response

Connected workspace metadata.

botUserIdstring nullable

Bot user id in the workspace.

connectedboolean required

Whether the workspace connection was stored.

scopestring nullable

Granted bot scopes, comma-separated.

teamIdstring required

Slack workspace (team) id — the key Events API deliveries resolve against.

teamNamestring nullable

Workspace display name.

Example response

{
  "botUserId": "U0BOT",
  "connected": true,
  "scope": "channels:history,channels:read",
  "teamId": "T0EXAMPLE",
  "teamName": "Acme"
}

Changes

No operation changes recorded.