Skip to main content
PATCH
/
webhook
/
{webhookId}
cURL
curl --request PATCH \
  --url https://api.joinslash.com/webhook/{webhookId} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "status": "active",
  "reason": "<string>"
}
'
{
  "id": "<string>",
  "createdAt": "<string>",
  "url": "<string>",
  "name": "<string>",
  "status": "active",
  "archivedAt": "<string>",
  "pausedAt": "<string>",
  "backingOffUntil": "<string>",
  "disabledAt": "<string>"
}

Authorizations

​
X-API-Key
string
header
required

Authentication from public API requests

Path Parameters

​
webhookId
string
required

Body

application/json
​
status
enum<string>
required

The desired status for the endpoint:

  • active: Enable/re-enable the endpoint
  • paused: Pause the endpoint (notifications are queued)
  • archived: Archive the endpoint (soft delete)
Available options:
active,
paused,
archived
​
reason
string

Optional reason for the status change (for audit purposes)

Response

OK

​
id
string
required
​
createdAt
string
required
​
url
string
required

The URL that will receive the webhook payload

​
name
string
required

The name of the webhook

​
status
enum<string>
required

The current status of the webhook endpoint:

  • active: The webhook is enabled and receiving events normally.
  • paused: The webhook has been paused by the user. Events are queued and will be delivered when the endpoint is set back to active.
  • backing-off: The system is temporarily backing off due to delivery failures. Delivery will be automatically retried at backingOffUntil. You can also immediately re-enable by setting status to active via the PATCH endpoint.
  • disabled: The webhook has been automatically disabled due to repeated delivery failures. Re-enable by setting status to active via the PATCH endpoint.
Available options:
active,
paused,
backing-off,
disabled
​
archivedAt
string
​
pausedAt
string

When the endpoint was paused by the user (ISO 8601 timestamp)

​
backingOffUntil
string

When the system will automatically retry delivery (ISO 8601 timestamp). Only present when status is backing-off.

​
disabledAt
string

When the endpoint was automatically disabled due to repeated failures (ISO 8601 timestamp). Only present when status is disabled.