SaaSFlow
DevelopersAPIReferenceagent_runs

List agent runs

List a company's agent runs with the SaaSFlow REST API. Request parameters, response fields, and an interactive playground.

Authentication

You're not signed in. Either sign in at app.saasflow.com and reload (then pick sessionCookie), or paste a SaaSFlow sf_… API key in the bearerAuth field below.
GET
/companies/{companyId}/agent_runs

Authorization

Authorization<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.

In: header

Path Parameters

companyId*string

Response Body

application/json

curl -X GET "https://example.com/companies/string/agent_runs"
[  {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "companyId": "8bb73d03-06b4-47c7-80c7-59301f770eda",    "definitionId": "string",    "status": "open",    "triggeredByUserId": "d1704798-c073-4631-a9e3-ed8329695e39",    "suppressNotification": true,    "createdTime": "2019-08-24T14:15:22Z",    "finishedTime": "2019-08-24T14:15:22Z",    "error": "string",    "errorDetails": "string",    "sessionId": "string",    "cloudRunExecutionId": "string",    "lastHeartbeatTime": "2019-08-24T14:15:22Z",    "costUsd": "string",    "data": "string"  }]

List agent definitions

List a company's agent definitions with the SaaSFlow REST API. Request parameters, response fields, and an interactive playground.

Create agent run

Create a agent run with the SaaSFlow REST API. Request parameters, response fields, and an interactive playground.