Skip to main content
PUT
cURL

Authorizations

Authorization
string
header
required

Send your API key as Authorization: Bearer YOUR_API_KEY.

Path Parameters

id
string
required

The TFU Live agent id, with its tfu_live: prefix, as GET /api/tfu-live-agents returns it. Other agent ids are refused.

workflowId
string
required

The workflow’s id: wf_ and 8 lowercase letters or digits.

Pattern: ^wf_[a-z0-9]{8}$

Query Parameters

locationId
string
required

The sub-account. It must belong to the agency, and be the credential’s own sub-account when the credential is limited to one.

Body

application/json

{ ifVersion, workflow }: the version you read, and the workflow as it should be. Its tool, if sent, is ignored.

ifVersion
string
required

The agent’s ifVersion from your last read, such as GET /api/tfu-live-agents/{id}. If the agent changed since, the request is refused with 409.

Minimum string length: 1
workflow
object
required

The workflow as it should be, in full. It keeps the id in the path.

Response

Successful TFU Live response. Setup acceptance is not verified readiness or campaign activation.

success
any
required
data
object
required