Skip to Content
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
Formatuuid
id*string
Formatuuid

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]?
Example Request
curl -X GET 'https://api.saasflow.com/companies/497f6eca-6276-4993-bfeb-53cbbbba6f08/agent_runs/497f6eca-6276-4993-bfeb-53cbbbba6f08/messages'
Example Response
[  {    "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"  }]