Conversation Flow
Validate Agent Flow
Dry-run validation of a flow configuration
POST
Validate Agent Flow
Run validation on a candidate flow configuration without persisting changes. Returns the same errors that Update Agent Flow would return.Endpoint
Path parameters
string
required
Agent UUID. Used to scope validation (e.g., to check that referenced action IDs exist).
Request headers
string
required
Bearer token. Format:
Bearer talq_your_environment_token_herestring
required
Must be set to
application/jsonRequest body
object
required
Same shape as in Update Agent Flow.
Examples
Response
Valid
Invalid
Notes
- Use this from your editor before submitting an update — surfaces issues early without modifying agent state.
- Validation rules cover: unique node IDs, reachability, valid
next/branchestargets, required fields per nodetype.