Set one alert target

PUT

/v2/projects/{project}/alerts/targets/{name}

Creates or replaces the target named in the path.

Authorization

AuthorizationBearer <token>

An API token from POST /v2/tokens (at_live_...), or a project's secret key (sk_...) for server-side ingest.

In: header

Path Parameters

project*string

The project id, as listed by GET /v2/projects.

Length1 <= length

name*string

The target's name within the project, used in its paths; defaults to the channel name.

Match^[a-z0-9][a-z0-9-]*$

Length1 <= length <= 40

Request Body

TypeScript Definitions

Use the request body type in TypeScript.

channel*string

name?string

The target's name within the project, used in its paths; defaults to the channel name.

Match^[a-z0-9][a-z0-9-]*$

Length1 <= length <= 40

on?array<>

The alert events the target receives; both issue events by default.

Items1 <= items

enabled?boolean

Set to false to pause it; true by default.

to*array<>

Mail recipients.

Items1 <= items <= 20

Response Body

`application/json`

curl -X PUT "https://example.com/v2/projects/string/alerts/targets/string" \  -H "Content-Type: application/json" \  -d '{    "channel": "mail",    "to": [      "user@example.com"    ]  }'

{  "data": {    "created": [      "string"    ],    "updated": [      "string"    ],    "removed": [      "string"    ],    "secrets": {}  }}

Set one alert target

AuthorizationCopy Anchor Link

Path ParametersCopy Anchor Link

Request BodyCopy Anchor Link

Response BodyCopy Anchor Link

200application/json

400application/json

401application/json

403application/json

404application/json

409application/json

500application/json

503application/json

Authorization

Path Parameters

Request Body

Response Body

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`