Skip to content

Get a webhook endpoint

GET
/v1/webhooks/{webhookId}
curl --request GET \
--url https://api.roundrobinbot.eu/v1/webhooks/example \
--header 'Authorization: Bearer <token>'

One endpoint, with an ETag: that validator is what every write against it has to carry. Never the signing secret, which exists only in your hands.

webhookId
required
string

OK

Media typeapplication/json

A registered destination: where Round Robin posts this workspace’s events, what it is subscribed to, and whether we are still calling it. Never the signing secret.

object
id
string
name

What the receiving system is called. Shown in the dashboard, never used for lookup.

string
url

Where we post. Always https.

string
eventTypes

What this endpoint receives: duty.changed, nobody.on_call, rotation.created, rotation.updated, rotation.deleted.

Array<string>
state

enabled or disabled. There is no revoked state: delete the endpoint instead.

string
disabledReason

Why we stopped calling: manual, delivery_failures or plan_downgrade. Absent while the endpoint is enabled.

null | string
currentSecretId

Which secret is signing now, so your logs and ours name the same one.

null | string
currentSecretCreatedAt
null | string format: date-time
previousSecretId

The outgoing secret during a rotation’s grace window, absent at every other time.

null | string
previousSecretExpiresAt

When the outgoing secret stops signing. Until then both signatures travel in one header, so a receiver can cut over without an outage.

null | string format: date-time
createdAt

When the endpoint was registered.

string format: date-time
updatedAt
null | string format: date-time
Examplegenerated
{
"id": "example",
"name": "example",
"url": "example",
"eventTypes": [
"example"
],
"state": "example",
"disabledReason": "example",
"currentSecretId": "example",
"currentSecretCreatedAt": "2026-04-15T12:00:00Z",
"previousSecretId": "example",
"previousSecretExpiresAt": "2026-04-15T12:00:00Z",
"createdAt": "2026-04-15T12:00:00Z",
"updatedAt": "2026-04-15T12:00:00Z"
}

Bad Request

Media typeapplication/json
object
type
null | string
title
null | string
status
null | integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
detail
null | string
instance
null | string
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example"
}

Unauthorized

Media typeapplication/json
object
type
null | string
title
null | string
status
null | integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
detail
null | string
instance
null | string
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example"
}

Forbidden

Media typeapplication/json
object
type
null | string
title
null | string
status
null | integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
detail
null | string
instance
null | string
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example"
}

Not Found

Media typeapplication/json
object
type
null | string
title
null | string
status
null | integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
detail
null | string
instance
null | string
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example"
}