Skip to content
TriedDocs
Conversation flows

Get conversation flow

Retrieve a conversation flow, the latest version or a specific one.

GEThttps://api.tried.com.au/get-conversation-flow/{conversation_flow_id}

Returns one version of a flow. Without version you get the latest.

Request#

Path parameters#

Parameter Type Required Description
conversation_flow_id string Yes The flow.

Query parameters#

Parameter Type Required Description
version integer No Version number, 0 or more.

Example request#

curl "https://api.tried.com.au/get-conversation-flow/conversation_flow_2c3d4e5f6a7b8c9d0e1f2a3b" \
  -H "Authorization: Bearer $TRIED_API_KEY"
const res = await fetch("https://api.tried.com.au/get-conversation-flow/conversation_flow_2c3d4e5f6a7b8c9d0e1f2a3b", {
  headers: { Authorization: `Bearer ${process.env.TRIED_API_KEY}` },
});
const data = await res.json();
import os, requests

res = requests.get(
    "https://api.tried.com.au/get-conversation-flow/conversation_flow_2c3d4e5f6a7b8c9d0e1f2a3b",
    headers={"Authorization": f"Bearer {os.environ['TRIED_API_KEY']}"},
)
data = res.json()

Response#

200 OK with the flow.

Errors#

Status When
400 version is not a non-negative integer.
401 Missing or invalid API key.
403 The key's IP allowlist or scopes reject the request. This route needs the agents scope.
404 The flow or version does not exist.
429 Rate limit exceeded. See Rate limits.

See Errors for the body format.