API ReferenceFlow Functions

Update a flow function

PUT /api/v1/flow-functions/{id}

Authentication

AuthorizationBearer

Pass a JWT access token or an API key (prefixed with tif_live_) as a Bearer token.

Path parameters

idstringRequiredformat: "uuid"

Request

This endpoint expects an object.
descriptionstring or nullOptional

Updated description (1-1000 characters)

isActiveboolean or nullOptional
Updated active status
namestring or nullOptional

Updated display name (1-255 characters)

paramBindingsobject or nullOptional

Updated per-parameter bindings. Omit to keep existing; {} to clear to all-LLM behavior; object to replace.

requestobject or nullOptional

Structured HTTP request shape.

pathParams, queryParams, and body are each JSON Schema objects. Parameter names MUST be unique across the three — the name decides which HTTP location a value is sent in.

timeoutMsinteger or nullOptional

Updated timeout in milliseconds (100-30000)

webhookHeadersobject or nullOptional

Updated headers (encrypted at rest). Pass null to clear, omit to keep existing.

Response

Flow function updated
accountIdstringformat: "uuid"
Account that owns this function
createdAtdatetime
Creation timestamp
descriptionstring
Description of what the function does
hasWebhookHeadersboolean

Whether encrypted headers are configured (never exposes actual headers)

idstringformat: "uuid"
Unique identifier
isActiveboolean
Whether the function is active
namestring
Display name
paramBindingsobject

Per-parameter source bindings keyed by flat param name. Empty object {} means all params are LLM-extracted. See CreateFlowFunctionRequest.param_bindings.

requestobject

Structured HTTP request shape (method, url, pathParams, queryParams, body)

slugstring

URL-safe slug

timeoutMsinteger
Timeout in milliseconds
updatedAtdatetime
Last update timestamp

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error