SaaSFlow
DevelopersAPIReferenceagent_runs

Create message

Send a follow-up message to a running interactive agent, up to 8000 characters. The message is queued rather than answered inline, so poll the messages…

Authentication

Checking whether you're signed in…
POST
/companies/{companyId}/agent_runs/{id}/messages

Authorization

headerAuthorization<token>

A SaaSFlow API key (format sf_…) or an OAuth bearer token. Paste only the key — the proxy adds the Bearer prefix. Create an API key in Settings → Company settings → API keys — see API keys.

Path Parameters

companyId*string
Length1 <= length
id*string
Length1 <= length

Request Body

application/json
  1. body
content*string
Length1 <= length <= 8000

Response Body

Message queued for the agent

application/json
  1. response
id*string
Formatuuid
companyId*string
Formatuuid
runId*string

The interactive agent run this message belongs to.

Formatuuid
role*string

Who authored the message: user, assistant, or system.

Value in"user""assistant""system"
userId*|

The member who wrote a user message; null for assistant and system rows.

Formatuuid
content*string

The message text.

createdTime*string
Formatdate-time
curl -X POST 'https://api.saasflow.com/companies/string/agent_runs/string/messages' \  -H 'Content-Type: application/json' \  -d '{  "content": "string"}'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "companyId": "8bb73d03-06b4-47c7-80c7-59301f770eda",  "runId": "78c33d18-170c-44d3-a227-b3194f134f73",  "role": "user",  "userId": "2c4a230c-5085-4924-a3e1-25fb4fc5965b",  "content": "string",  "createdTime": "2019-08-24T14:15:22Z"}

List messages

Read the conversation of an agent run, oldest first. Poll with afterId set to the last id you saw to stream new messages without refetching the thread.

Transcript

Download the full session transcript as JSON Lines: every message and every tool call the agent made, which is the record to read when debugging what an…