WebhooksTrigger a published flow

Trigger a published flow

Runtime entry point for TurboFlow. Sign the raw request body with SHA-256 HMAC using the published version's trigger_secret and send the digest in X-Talkturo-Secret. Async mode (default) returns 202 with run_id. Sync mode (?sync=true) waits up to about 30 seconds for inline output.

curl -X POST "https://api.talkturo.com/api/flow/example_string/trigger?sync=true" \
  -H "Content-Type: application/json" \
  -H "X-Talkturo-Secret: example_string" \
  -H "X-Talkturo-Secret: YOUR_API_KEY" \
  -d '{
  "params": {},
  "context": {
    "assistant_id": "example_string"
  }
}'
{
  "ok": true,
  "run_id": "example_string",
  "output": {},
  "error": "example_string",
  "failed_node": "example_string",
  "partial_output": {}
}
POST
/flow/{flowId}/trigger
POST
Base URLstring

Target server for requests. Edit to use your own host.

API Key (header: X-Talkturo-Secret)
X-Talkturo-Secretstring
Required

SHA-256 HMAC digest of the raw request body. Used for TurboFlow published flow triggers (key = version trigger_secret) and some integration webhooks.

SHA-256 HMAC digest of the raw request body. Used for TurboFlow published flow triggers (key = version trigger_secret) and some integration webhooks.
query
syncboolean

Wait for final output inline when true

Content-Typestring
Required

The media type of the request body

Options: application/json
header
X-Talkturo-Secretstring
Required

SHA-256 HMAC digest of the raw request body

paramsobject
Required

Runtime input key-value pairs

Request Preview
Response

Response will appear here after sending the request

Authentication

header
X-Talkturo-Secretstring
Required

API Key for authentication. SHA-256 HMAC digest of the raw request body. Used for TurboFlow published flow triggers (key = version trigger_secret) and some integration webhooks.

Path Parameters

flowIdstring
Required

Flow identifier

Query Parameters

syncboolean

Wait for final output inline when true

Headers

X-Talkturo-Secretstring
Required

SHA-256 HMAC digest of the raw request body

Body

application/json
paramsobject
Required

Runtime input key-value pairs

contextobject

Responses

okboolean
run_idstring
outputobject
errorstring
failed_nodestring
partial_outputobject