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
List a project's notification destinations GETAdd a notification destination POSTGet a notification destination GETUpdate a notification destination PATCHDelete a notification destination DELETESend a test message POSTGet a webhook's signing secret GETGive a webhook a new signing secret POSTGet your notification preferences for a project GETSet your notification preferences for a project PUTList a destination's deliveries GETGet a delivery with its body and attempts GETRedeliver POST
REST APINotifications

List a project's notification destinations

Send a comment to a coding agent POST

Starts a run of the project's Claude Code scheduled task, or dispatches `annoty-comment` to its GitHub repository, with the comment. Threads only: a reply's id is a 404. Every call starts another run. Requires `comment:sendToAgent` and a plan with `agents`.

Add a notification destination POST

Up to 10 per project, coding agents included. A webhook's response has its signing secret. Requires `notificationDestination:create` and a plan with the type's feature (Discord: `integrations`, webhook: `webhooks`, coding agents: `agents`). Webhooks are refused (400) while they aren't available to the organization yet.

GET
/v1/projects/{projectId}/notification-destinations

Newest first, including those for a single feedback session. Requires notificationDestination:read.

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

projectId*string

Query Parameters

limit?integer

Items per page, 1 to 100

Range1 <= value <= 100
Default20
cursor?string

nextCursor from the previous page

Response Body

A page of notification destinations

application/json
  1. response
  1. response
  2. …
data*array<>
nextCursor*|

Pass as cursor for the next page; null on the last page

Example Request
curl -X GET 'https://api.annoty.app/v1/projects/string/notification-destinations'
Example Response
{
  "data": [
    {
      "id": "string",
      "projectId": "string",
      "feedbackSessionIds": [
        "string"
      ],
      "type": "discord",
      "name": "string",
      "urlPreview": "string",
      "events": [
        "comment.created"
      ],
      "enabled": true,
      "lastError": "string",
      "lastErrorAt": "2019-08-24T14:15:22Z",
      "hasAnnotyApiKey": true,
      "createdAt": "2019-08-24T14:15:22Z"
    }
  ],
  "nextCursor": "string"
}