SaaSFlow
DevelopersAPIReferenceagent_runs

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.

Authentication

Checking whether you're signed in…
GET
/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

Query Parameters

afterId?string

Return only messages with an id greater than this.

Response Body

The run conversation messages, oldest first.

application/json
  1. response
[index: integer]?
curl -X GET 'https://api.saasflow.com/companies/string/agent_runs/string/messages'
[  {    "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"  }]

Retrieve agent run

Retrieve one agent run: its status, the input it was started with, and its result once finished. Poll this after starting a run.

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…