Using the Agent Runs API

Last updated: July 13, 2026

The Agent Runs API lets you retrieve outputs from scheduled or event-triggered Airspeed Agents programmatically. Use it when you want to export agent output, sync it into another system, or build reporting around recurring agent runs.

Note: This API is for scheduled and event-triggered run outputs. It is not a general API for interactive one-time chat conversations.

Prerequisites

  • An Airspeed API key for your organization.

  • At least one scheduled or event-triggered agent with completed runs.

  • The ID of an agent, legacy agent workflow, user, call, or run if you want to filter results.

List agent runs

GET /agent-runs

Results are scoped to the organization for the API key and sorted newest first.

Supported filters

Query parameter

Use it to...

agent_id

Filter to runs from a native scheduled agent.

agent_workflow_id

Filter to runs from a legacy agent workflow.

user_id

Filter to runs owned by a user.

call_id

Filter to runs associated with a call.

Important: agent_id and agent_workflow_id are mutually exclusive. Supplying both returns an error.

Example

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.goairspeed.com/agent-runs?agent_id=AGENT_ID"

Get a single agent run

GET /agent-runs/{run_id}

Use this endpoint to retrieve the full output for one run. List results include previews; the detail endpoint returns the full final output.

Example

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.goairspeed.com/agent-runs/RUN_ID"

Common use cases

  • Export weekly pipeline digest outputs into a data warehouse.

  • Sync closed-won handoff summaries into an internal customer success system.

  • Archive recurring competitive intelligence reports.

  • Pull post-call agent outputs for internal QA or reporting.

Troubleshooting

I get a 400 error

Check whether both agent_id and agent_workflow_id were supplied. Use only one.

I get a 404 error

Confirm the run ID exists and belongs to the organization for your API key.

The output is only a preview

Use GET /agent-runs/{run_id} to fetch the full run output.

Related articles

  • :page_facing_up: Managing API Keys

  • :page_facing_up: Creating and managing Airspeed Agents