Skip to Content
SaaSFlow
DevelopersAPIReferenceagent_runs

List agent runs

List this company's agent runs, past and in progress, with their status and which definition they came from. Use it to find a run id, or to check whether…

Authentication

Checking whether you're signed in…
GET
/companies/{companyId}/agent_runs

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

Response Body

List of agent runs

application/json
  1. response
[index: integer]?
Example Request
curl -X GET 'https://api.saasflow.com/companies/497f6eca-6276-4993-bfeb-53cbbbba6f08/agent_runs'
Example Response200
[  {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "companyId": "8bb73d03-06b4-47c7-80c7-59301f770eda",    "definitionId": "string",    "status": "open",    "triggeredByUserId": "d1704798-c073-4631-a9e3-ed8329695e39",    "suppressNotification": true,    "impersonatedBy": "string",    "createdTime": "2019-08-24T14:15:22Z",    "finishedTime": "2019-08-24T14:15:22Z",    "error": "string",    "errorDetails": "string",    "sessionId": "string",    "resumedFromRunId": "666b0c5a-138f-4104-834e-8a1ebe30fa3b",    "cloudRunExecutionId": "string",    "lastHeartbeatTime": "2019-08-24T14:15:22Z",    "costUsd": "string",    "data": "string"  }]