Skip to main content
PATCH
Change, pause or resume an endpoint

Authorizations

Authorization
string
header
required

An API key from Settings → API keys, sent as Authorization: Bearer yk_live_…. Scopes: transfers:read, transfers:write, collections:read, collections:write, contacts:read, contacts:write, webhooks:read, webhooks:write. A write scope implies read of the same resource.

Path Parameters

id
string
required

Webhook endpoint id.

Body

application/json
url
string | null
Maximum string length: 2000
events
enum<string>[]

Event types to receive. Collection events need a paid plan.

Required array length: 1 - 20 elements
Available options:
transfer.ready,
transfer.downloaded,
transfer.expiring,
transfer.expired,
collection.file_uploaded,
request.submitted
description
string | null
Maximum string length: 200
enabled
boolean

false pauses deliveries; true resumes and resets the failure count.

Response

The endpoint.

webhook
object
required