Skip to main content
PUT

Update Agent Flow

Update an agent’s conversation mode and (when applicable) the structured flow configuration. Submitting an invalid flow returns a 422 with details — use Validate Agent Flow to dry-run validation before saving.

Endpoint

Path parameters

string
required
Agent UUID.

Request headers

string
required
Bearer token. Format: Bearer talq_your_environment_token_here
string
required
Must be set to application/json

Request body

string
required
Conversation mode. Options:
  • llm_driven — LLM-guided conversation (knowledge + actions). Send flow_config: null or omit.
  • flow_driven — node-graph driven. flow_config is required.
object
Flow definition. Required when conversation_mode is flow_driven.

Examples

Response

Error responses

422 — Invalid Flow

Notes

  • Updating the flow does not change the agent’s status — but published agents need to be re-published if the flow change is breaking.
  • See List Flow Versions to track historical configurations.