curl --request GET \
--url https://breadbox.example.com/api/v1/agents/runs \
--header 'X-API-Key: <api-key>'{}List runs across all agents
Cross-agent run history. Each row carries agent_slug + agent_name
in addition to the standard run fields, so callers can render an
agent column without a second fetch. Powers the v2 SPA’s global
/v2/agents/runs view. Same filters as /agents/{slug}/runs,
plus the optional agent=<slug> narrowing filter.
curl --request GET \
--url https://breadbox.example.com/api/v1/agents/runs \
--header 'X-API-Key: <api-key>'{}Documentation Index
Fetch the complete documentation index at: https://docs.breadbox.sh/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
Breadbox API key with format bb_<base62>. Carries either read_only
or full_access scope. Write endpoints (and a handful of sensitive
reads — /api-keys, /users/{user_id}/login) require full_access;
endpoints that require it are flagged in their description.
Query Parameters
x <= 200Optional slug or UUID to narrow to one definition
success, error, in_progress, skipped, timeout cron, manual, webhook max_turns, max_budget, any YYYY-MM-DD or RFC3339; inclusive lower bound on started_at
YYYY-MM-DD or RFC3339; inclusive upper bound on started_at
Response
Paginated runs envelope {runs, limit, offset, has_more} where each run includes agent_slug + agent_name.
The response is of type object.