Skip to content
Pong Docs

Update an alert contact

PUT
/api/v1/alert-contacts/{id}

Updates an existing alert contact. Only the fields provided in the request body are changed.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
id
required
integer
Example
1

Unique alert contact identifier.

Request Body required

Section titled “Request Body required ”

Request body for updating an alert contact. All fields are optional.

object
name

Human-readable label.

string
Example
Engineering Slack
type

Notification channel type.

string
Allowed values: email slack webhook
Example
slack
value

Channel address.

string
Example
https://hooks.slack.com/services/T00/B00/xxx

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Alert contact updated successfully.

A contact channel for receiving alerts.

object
id
required

Unique alert contact identifier.

integer
Example
1
user_id
required

ID of the user who owns this contact.

integer
Example
1
type
required

Notification channel type.

string
Allowed values: email slack webhook
Example
email
value
required

Channel address (email, Slack webhook URL, or webhook URL).

string
Example
ops@example.com
name
required

Human-readable label for this contact.

string
Example
Ops Team Email
verified

Whether the contact has been verified. Email contacts require verification before receiving alerts. Slack and webhook contacts are verified automatically.

boolean
Example
true
created_at
required

When the contact was created.

string format: date-time
Example
2026-01-10T09:00:00Z

400

Section titled “400 ”

The request body is invalid or missing required fields.

Error response returned when a request fails.

object
error
required

A human-readable error message.

string
Example
monitor not found
Example
{
  "error": "invalid request body"
}

401

Section titled “401 ”

Authentication credentials are missing or invalid.

Error response returned when a request fails.

object
error
required

A human-readable error message.

string
Example
monitor not found
Example
{
  "error": "unauthorized"
}

404

Section titled “404 ”

The requested resource was not found.

Error response returned when a request fails.

object
error
required

A human-readable error message.

string
Example
monitor not found
Example
{
  "error": "not found"
}