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

See what a Slack link would connect

List a workspace's channels GET

Public channels, and private ones @Annoty was invited to. One page of Slack's list, which can't be searched. Requires `notificationDestination:create`.

List the signed-in member's linked Slack accounts GET

Session only.

GET
/v1/slack/links/preview

What the confirm page shows before anything changes, since link previews open links. 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.

Query Parameters

token*string
Length1 <= length

Response Body

The Slack account

application/json
  1. response
  1. response
  2. …
teamId*string
teamName*string
slackUserId*string
slackUserName*string
Example Request
curl -X GET 'https://api.annoty.app/v1/slack/links/preview?token=string'
Example Response
{
  "teamId": "string",
  "teamName": "string",
  "slackUserId": "string",
  "slackUserName": "string"
}