Set where an alert channel sends
consoleSessionvg_session<token>The console's session cookie, set when you sign in. Every operation accepts it, at the role the operation names.
orgId*stringAuthorised orgId; the server must verify organisation/project ownership before any read.
1 <= lengthprojectId*stringAuthorised projectId; the server must verify organisation/project ownership before any read.
1 <= lengthkind*stringA channel kind; any other value is not_found.
"email""webhook""slack""teams""discord""pagerduty""opsgenie"application/json- body
url?stringWebhook: the http or https URL each delivery is POSTed to (https only on Cloud). Slack, Teams, Discord: the provider's incoming webhook URL, https://hooks.slack.com/services/..., a Teams Workflows URL on logic.azure.com or api.powerplatform.com, or https://discord.com/api/webhooks/.... Sealed on the server and never returned.
length <= 2048rotateSecret?booleanWebhook only: true makes a new signing secret, returned once.
recipients?array<>Email only: 1 to 20 addresses that get every alert as one email.
1 <= items <= 20key?stringPagerDuty: the Events API v2 integration (routing) key, 32 characters. Opsgenie: the API integration key. Sealed on the server and never returned.
length <= 64region?stringPagerDuty and Opsgenie only: the provider's service region, events.pagerduty.com or events.eu.pagerduty.com, api.opsgenie.com or api.eu.opsgenie.com.
"us""us""eu"The channel as saved, with a new signing secret when one was made.
application/json- response
kind*stringThe channel kind.
"email""webhook""slack""teams""discord""pagerduty""opsgenie"target*stringWhat the channel sends to, safe to show: the host it posts to, or the recipient count.
recipients*array<string>|The email channel's recipients.
signingSecret*|The webhook's Standard Webhooks signing secret (whsec_...), returned only when it was made. Verify each delivery's webhook-signature with it.
curl -X PUT 'https://example.com/api/v1/org/string/project/string/alert-channels/email' \ -H 'Content-Type: application/json' \ -d '{}'{ "kind": "email", "target": "string", "recipients": [ "string" ], "signingSecret": "string"}Was this page helpful?