flow_conversations

list conversation messages

Changed on
get/w/{workspace}/flow_conversations/{conversation_id}/messages

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/w/{workspace}/flow_conversations/{conversation_id}/messages
  • Auth: one of:
    • HTTP bearer
    • API key in cookie token

Path parameters

workspacestring required
conversation_idstring uuid required

conversation id

Query parameters

pageinteger

which page to return (start at 1, default 1)

per_pageinteger

number of items to return for a given page (default 30, max 100)

after_seqinteger

Message sequence cursor to fetch only the messages after that cursor

Response

conversation messages

idstring uuid required

Unique identifier for the message

conversation_idstring uuid required

The conversation this message belongs to

message_type'user' | 'assistant' | 'system' | 'tool' required

Type of the message

contentstring required

The message content

job_idstring uuid nullable

Associated job ID if this message came from a flow run

created_atstring date-time required

When the message was created

created_seqinteger required

Monotonic cursor assigned when the message is inserted

step_namestring

The step name that produced that message

successboolean

Whether the message is a success

tool_argumentsstring nullable

On a tool row, the arguments the model wrote for the call. For a script, flow or AI agent tool these exclude the inputs its step wires in, which only the tool's job holds. Null for a provider-native web search, whose query the provider does not return.

tool_resultstring nullable

On a tool row, the text the model got back from the call, or what the call failed with — the row's own text names the tool rather than the reason. For a provider-native web search, its citations.

reasoningstring nullable

On an answer, the thinking that produced it; on a tool row, the thinking that led to the call. Each round's thinking is on one row. The agent job's result keeps the turn's thinking as a single string.

Changes

  • 285dfb1eb9ffRevision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status