Skip to main content
POST
Create thread

Authorizations

x-api-key
string
header
required

Project API key. Create and manage keys in the dashboard under Project → API Keys. Send as header: x-api-key:

Headers

x-username
string
default:(project default user)

External user (end user) to act as. Optional — if omitted, Flowra uses the project’s default external user. Send a stable username (e.g. customer_alice) only when you need another end-user context.

Body

application/json
metadata
object

Arbitrary thread metadata stored with the conversation (title, tags, workflowId, …).

Example:

Response

Thread created

thread_id
string
required

Thread ID

Example:

"b737d8af-a9e0-4251-9714-3fdc1126e5fb"

created_at
string

Created at (ISO 8601)

updated_at
string

Updated at (ISO 8601)

metadata
object

Thread metadata

status
string

Thread status

Example:

"idle"

values
object

Current graph values