Webhooks
Every Webhooks tool, with the scope it needs, its arguments and the API operation it calls.
14 tools
List webhook admin deliveries
Read onlyatlas_webhooks_admin_deliveries_list
List webhook deliveries across the workspace, newest first, filtered by subscription, status and a time range. Each row has the event type, status, response status, attempts and timing. Returns { items, nextCursor }. Use this to find failed or dead deliveries.
- Scope
webhooks:manage- Calls
- Example prompt
- Which webhook deliveries failed in the last 24 hours?
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
webhookId | string | No | Only deliveries for this webhook subscription id. |
status | "pending" | "sending" | "success" | "failed" | "dead" | No | Only deliveries in this state. |
fromTs | string (date-time) | No | Only deliveries created at or after this ISO 8601 time. |
toTs | string (date-time) | No | Only deliveries created at or before this ISO 8601 time. |
limit | integer | No | Page size, 1 to 200. Defaults to 50. |
cursor | string | No | The nextCursor from the previous page. |
Retry webhook admin deliveries
Changes dataatlas_webhooks_admin_deliveries_retry
Queue a fresh attempt of one webhook delivery to the same subscription with the same payload. Returns the new delivery row, in the pending state. Use this once the receiver has recovered from an outage.
- Scope
webhooks:manage- Calls
- Example prompt
- Retry delivery dlv_abc now that the receiver is back online.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | The webhook delivery id. |
Get webhook admin delivery payloads
Read onlyatlas_webhooks_admin_delivery_payloads_get
Read one webhook delivery in full: the event payload that was sent, its signature and signature version, the receiver response status, body and headers, the duration, the last error and the attempt count. Use this to diagnose why a receiver rejected a delivery.
- Scope
webhooks:manage- Calls
- Example prompt
- Why did the receiver reject delivery dlv_abc? Show me the response.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | The webhook delivery id. |
Create webhooks
Changes dataatlas_webhooks_create
Create a new outbound webhook subscription. Atlas generates the HMAC signing secret and returns it once in the response; store it then. Use atlas_webhooks_signing_keys_rotate to issue a new one.
- Scope
webhooks:manage- Calls
- Example prompt
- Wire a webhook for task.completed events to https://hooks.example.com/atlas.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
url | string (uri) | Yes | Destination URL. Must be a public https URL. |
events | array of string | Yes | Event patterns (e.g. "task.*", "project.created"). |
ownerLabel | string | null | No | Name of the team or person who owns this endpoint. Pass null to clear it. |
escalationEmail | string (email) | null | No | Email address to alert when deliveries keep failing. Pass null to clear it. |
escalationNote | string | null | No | Short runbook note for whoever handles a failing endpoint. Pass null to clear it. |
Delete webhooks
Destructiveatlas_webhooks_delete
Delete a webhook subscription. Cancels any in-flight retries.
- Scope
webhooks:manage- Calls
- Example prompt
- Remove webhook whk_xyz - we cut over to the new endpoint.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes |
List webhook deliveries
Read onlyatlas_webhooks_deliveries_list
List recent webhook deliveries across all webhooks (or filter to one).
- Scope
webhooks:manage- Calls
- Example prompt
- What webhooks fired in the last hour?
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
webhookId | string | No | Restrict to one webhook. |
limit | integer | No |
Replay webhook deliveries
Changes dataatlas_webhooks_deliveries_replay
Replay a previously-failed webhook delivery.
- Scope
webhooks:manage- Calls
- Example prompt
- Retry the failed delivery from this morning.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
webhookId | string | Yes | |
deliveryId | string | Yes |
Retry webhook deliveries
Changes dataatlas_webhooks_deliveries_retry
Retry a webhook delivery by delivery id without needing the parent webhook id. Hits POST /v1/webhook-deliveries/:id/retry.
- Scope
webhooks:manage- Calls
- Example prompt
- Retry delivery dlv_abc - the receiver is back online.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
deliveryId | string | Yes | Delivery id to retry, e.g. dlv_xyz. |
Get webhooks
Read onlyatlas_webhooks_get
Fetch a single webhook by id.
- Scope
webhooks:manage- Calls
- Example prompt
- Show me webhook whk_xyz.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes |
List webhooks
Read onlyatlas_webhooks_list
List outbound webhook subscriptions in this tenant.
- Scope
webhooks:manage- Calls
- Example prompt
- Which webhooks are wired up?
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
limit | integer | No |
Rotate webhook signing keys
Destructiveatlas_webhooks_signing_keys_rotate
Audit #20: rotate a webhook HMAC signing key. The previous key remains valid for a 24h grace window so receivers can swap without dropping deliveries. Returns the new plaintext secret ONCE.
- Scope
webhooks:manage- Calls
- Example prompt
- Rotate the signing key for webhook whk_xyz - we suspect the secret leaked.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Webhook id whose HMAC signing key should be rotated. |
Test webhooks
Changes dataatlas_webhooks_test
Ping a webhook with a synthetic test event so you can verify the receiver.
- Scope
webhooks:manage- Calls
- Example prompt
- Send a test event to webhook whk_xyz.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Webhook id to ping. |
Update webhooks
Changes dataatlas_webhooks_update
Update an existing webhook: URL, events, owner label, escalation contact, or pause it with disabled. The signing secret cannot be set here; use atlas_webhooks_signing_keys_rotate.
- Scope
webhooks:manage- Calls
- Example prompt
- Disable webhook whk_xyz temporarily.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | |
url | string (uri) | No | New destination URL. Must be a public https URL. |
events | array of string | No | |
ownerLabel | string | null | No | Name of the team or person who owns this endpoint. Pass null to clear it. |
escalationEmail | string (email) | null | No | Email address to alert when deliveries keep failing. Pass null to clear it. |
escalationNote | string | null | No | Short runbook note for whoever handles a failing endpoint. Pass null to clear it. |
disabled | boolean | No | Pass true to pause deliveries to this webhook, false to resume them. |
List webhook webhook deliveries
Read onlyatlas_webhooks_webhook_deliveries_list
List recent deliveries for one specific webhook id.
- Scope
webhooks:manage- Calls
- Example prompt
- What did webhook whk_xyz send today?
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Webhook id. |
limit | integer | No |