Skip to main content

TaskUpdateRequest

All fields are optional. At least one field must be provided. The SDK must NOT require status or conditionVersion specifically — delivery and entity_scope are equally valid standalone updates. Condition logic, concept definition, strategy, and action logic MUST NOT be modified via this endpoint — those require the calibration flow (calibrate → apply → rebind).

condition_versionstring

Rebind task to a new condition version (explicit user action)

delivery object
typestringrequired

Possible values: [webhook, notification, email, workflow]

channelstring

For notification/email delivery types

endpointstring

For webhook delivery type

workflow_idstring

For workflow delivery type

entity_scopestring

Update the entity or group this task evaluates against

statusstring

Use to pause or resume a task. Deletion must use DELETE /tasks/{id}.

Possible values: [active, paused]

TaskUpdateRequest
{
"condition_version": "string",
"delivery": {
"type": "webhook",
"channel": "string",
"endpoint": "string",
"workflow_id": "string"
},
"entity_scope": "string",
"status": "active"
}