Only the fields you send change. A coding agent takes a new token, and no events. Requires notificationDestination:update and a plan with the type's feature (Discord: integrations, webhook: webhooks, coding agents: agents).
apiKeyAuthorizationBearer <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.
destinationId*stringapplication/jsonname?string1 <= length <= 100url?stringA URL the destination's type takes: Discord's webhook URL for discord, any public https URL for webhook, the fire URL for claude_code, the repository for github_actions and cursor
annotyApiKey?|cursor only: a new Annoty API key for the agent's MCP server, or null to remove it
token?stringCoding agents only: a new token, checked against the destination's type like url
events?array<>Not for coding agents, which get no events
1 <= itemsenabled?booleanTurning a destination back on clears lastError
The updated notification destination
application/jsonid*stringprojectId*stringfeedbackSessionIds*array<string>The feedback sessions whose events it gets. Empty: every feedback session in the project that isn't muted
type*stringdiscord: a Discord channel's webhook. slack: a channel in a Slack workspace connected with POST /slack/install. webhook: any https URL, signed the Standard Webhooks way. claude_code: a Claude Code scheduled task's API trigger. github_actions: repository_dispatch on a GitHub repository, for Claude Code's or Codex's GitHub Action. cursor: a Cursor cloud agent on a GitHub repository. The last three are coding agents: POST …/comments/{commentId}/send-to-agent sends them a comment
"discord""slack""webhook""claude_code""github_actions""cursor"name*stringurlPreview*stringThe URL without its secret part: Discord's webhook id; a webhook's host, its path's first segment when more follow and the last 4 characters of the rest (n8n.acme.dev/webhook-test/…f3a9); a Claude Code trigger's id or a GitHub repository. The URL and any token are never returned
events*array<>The activity events this receives. Empty for coding agents (claude_code, github_actions): they get only the comments a member sends them
enabled*booleanlastError*|Why the last delivery failed. A webhook deleted on Discord's side also sets enabled to false
lastErrorAt*|date-timehasAnnotyApiKey*booleancursor: an Annoty API key is stored for the agent's MCP server, so it can read the whole comment and reply. Always false for other types
createdAt*stringdate-timecurl -X PATCH 'https://api.annoty.app/v1/notification-destinations/string' \
-H 'Content-Type: application/json' \
-d '{}'{
"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"
}