Skip to main content
PATCH
Update, resume or rotate a subscription

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

Integration id (I + 12 hex).

sid
string
required

Subscription id.

Body

application/json
url
string<uri>

https only. Private, loopback and link-local hosts are refused.

Maximum string length: 2048
spaces
string[]

Each space needs tasks:read on the integration.

Minimum array length: 1
event_kinds
enum<string>[]
Available options:
task-created,
task-updated,
task-status-changed,
task-moved,
task-deleted,
task-action-added,
task-action-completed,
task-action-deleted,
comment-created,
comment-updated,
comment-deleted
paused
enum<boolean>

Only false is accepted: it resumes and clears the failure counters. The delivery worker does the pausing.

Available options:
false
rotate_secret
boolean

Issues a new secret, returned once. The previous secret keeps signing for 24 hours.

Response

Updated.

data
object
required