Skip to Content
annotyDocs
annotyDocs
annoty.appDashboardGetting started

Share with reviewers

Proxy or embed?ProxyEmbedScreenshotsToolbar position

Coding agents

Coding agents (MCP)Send to agent

Integrations

SlackWebhooksDiscordEmailZapiern8n

Reference

GlossaryPlans and billingGet help and send feedback
REST API
Start connecting a Slack workspace POSTFinish connecting a Slack workspace POSTList connected Slack workspaces GETDisconnect a Slack workspace DELETEList a workspace's channels GETSee what a Slack link would connect GETList the signed-in member's linked Slack accounts GETLink a Slack account to the signed-in member POSTUnlink a Slack account DELETE
REST APISlack

Unlink a Slack account

Link a Slack account to the signed-in member POST

Buttons in Slack then act as this member. The workspace must be connected to one of the member's organizations. Session only.

List the organization's activity GET

What happened across the organization, newest first: comments, replies, resolves and reopens from every feedback session, and feedback sessions created, turned off, expired or deleted. Events show up a few seconds after they happen and are kept for 90 days. A deleted feedback session's events go with it, except its deletion. Requires `feedbackSession:read` and `comment:read`.

DELETE
/v1/slack/links/{teamId}/{slackUserId}

Buttons in Slack stop acting as this member. Session only.

Authorization

apiKey
headerAuthorizationBearer <token>

An organization API key from the dashboard (Settings → API keys), e.g. Authorization: Bearer annoty_.... x-api-key: annoty_... also works. While the organization has no subscription or trial, every request with a key except GET /v1/organization fails with 402 SUBSCRIPTION_REQUIRED.

Path Parameters

teamId*string
Length2 <= length <= 32
slackUserId*string
Length2 <= length <= 32

Response Body

Unlinked

Example Request
curl -X DELETE 'https://api.annoty.app/v1/slack/links/string/string'
Example Response
Empty