DevelopersAPIReferenceagent_definitions
List agent definitions
List the agents that can be run for this company, each with a title and a description of what it does. The id here is the definitionId you pass when…
Authentication
Checking whether you're signed in…
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
Length
1 <= lengthResponse Body
application/json
curl -X GET "https://example.com/companies/string/agent_definitions"[ { "id": "string", "title": "string", "description": "string" }]Retrieve background task
Retrieve one background task by id to check whether it is still running, what it produced, or why it failed. Returns 404 if the task does not exist or…
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…