OverviewPlatformsAPI Reference
Alerts

Rotate the signing secret

Gives a webhook channel a new signing secret, shown only in this response. The old secret stops working at once.

POST
/v1/channels/{id}/rotate-secret

Authorization

bearerAuth
AuthorizationBearer <token>

An API key from POST /v1/api-keys. Keys start with ref_.

In: header

Path Parameters

id*string

The channel's id (dest_...).

Length1 <= length

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/v1/channels/dest_abc123/rotate-secret"
{  "id": "string",  "label": "string",  "stats": {    "alerts": 0,    "activeAlerts": 0,    "lastDeliveryAt": "string",    "last7d": {      "total": 0,      "failed": 0    }  },  "createdAt": "string",  "kind": "slack",  "config": {    "channelId": "string",    "channelName": "string",    "events": [      "mention.spike"    ]  }}
Was this page helpful?

Mute authors

Adds authors to the alert's muted list and leaves the rest of its filter alone. Links are handled as in the dashboard, so a post link mutes its author, twitter.com turns into x.com and a Hacker News profile keeps its id. Authors who are already muted are skipped, so retrying is safe. An entry that is not a person, such as a subreddit or a story, fails the request and the error names it.

Send a digest now

Sends the digest for the alert's last hour, day or week now and returns each channel's outcome. Works on digest alerts only, and the schedule doesn't change.