Skip to content
Keptslot
Start free

Change an endpoint

PATCH
/v1/webhook-endpoints/{id}
curl --request PATCH \
--url https://api.keptslot.com/v1/webhook-endpoints/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "url": "example", "events": [ "example" ], "active": true }'

This endpoint changes one webhook endpoint. Send only the fields you want to change. A field you omit keeps its value.

Set active to false to stop deliveries and keep the endpoint.

id
required
string format: uuid

The webhook endpoint id.

Media type application/json
object
url
string
events
Array<string>
active
boolean
Example generated
{
"url": "example",
"events": [
"example"
],
"active": true
}

The endpoint is changed. No secret is in this response.

Media type application/json
object
id
required
string format: uuid
url
required
string
events
required

The event types this endpoint receives.

Array<string>
active
required
boolean
consecutive_failures
required

How many deliveries failed in a row. It returns to 0 after a success.

integer
last_success_at
string | null format: date-time
last_failure_at
string | null format: date-time
created_at
required
string format: date-time
secret

The signing secret. It is present ONLY on the create response. The stored form is sealed and no read path can reveal it again. Store it now. If you lose it, rotate it.

string
Example generated
{
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"url": "example",
"events": [
"example"
],
"active": true,
"consecutive_failures": 1,
"last_success_at": "2026-04-15T12:00:00Z",
"last_failure_at": "2026-04-15T12:00:00Z",
"created_at": "2026-04-15T12:00:00Z",
"secret": "example"
}

The key is missing, malformed or revoked.

Media type application/json
object
error
required
object
type
required

A stable machine-readable code. Match on this.

string
message
required

A sentence for a person. Do not match on this.

string
param

The field that caused the refusal, if one field did.

string
dimension

The plan limit that refused the request. It is present only on a 402, and only for a secret key or an account key. See the errors guide.

string
used

The current count for that dimension. It is present only on a 402, and only for an account key. It is absent when the refusal has no count to report. Absent and zero are different answers.

integer format: int64
limit

The cap for that dimension. It is present only on a 402, and only for an account key. A cap of zero is a real value.

integer format: int64
Example generated
{
"error": {
"type": "example",
"message": "example",
"param": "example",
"dimension": "example",
"used": 1,
"limit": 1
}
}

There is no such resource in this workspace.

Media type application/json
object
error
required
object
type
required

A stable machine-readable code. Match on this.

string
message
required

A sentence for a person. Do not match on this.

string
param

The field that caused the refusal, if one field did.

string
dimension

The plan limit that refused the request. It is present only on a 402, and only for a secret key or an account key. See the errors guide.

string
used

The current count for that dimension. It is present only on a 402, and only for an account key. It is absent when the refusal has no count to report. Absent and zero are different answers.

integer format: int64
limit

The cap for that dimension. It is present only on a 402, and only for an account key. A cap of zero is a real value.

integer format: int64
Example generated
{
"error": {
"type": "example",
"message": "example",
"param": "example",
"dimension": "example",
"used": 1,
"limit": 1
}
}

The request body or the query is not valid.

Media type application/json
object
error
required
object
type
required

A stable machine-readable code. Match on this.

string
message
required

A sentence for a person. Do not match on this.

string
param

The field that caused the refusal, if one field did.

string
dimension

The plan limit that refused the request. It is present only on a 402, and only for a secret key or an account key. See the errors guide.

string
used

The current count for that dimension. It is present only on a 402, and only for an account key. It is absent when the refusal has no count to report. Absent and zero are different answers.

integer format: int64
limit

The cap for that dimension. It is present only on a 402, and only for an account key. A cap of zero is a real value.

integer format: int64
Example generated
{
"error": {
"type": "example",
"message": "example",
"param": "example",
"dimension": "example",
"used": 1,
"limit": 1
}
}