Runs

GET /api/v1/runs

Recent agent runs.

GET /api/v1/runs

Recent agent runs.

Requires a key with read scope or higher.

Returns 200 on success.

Parameters

Name	In	Type	Required	Description
`limit`	query	number	no	Maximum rows to return.
`status`	query	`queued` \| `running` \| `succeeded` \| `failed` \| `canceled`	no
`project_id`	query	string	no	Restrict to one account.
`cursor`	query	string	no	Opaque keyset cursor — pass the previous page's `next_cursor`.
`before`	query	string	no	Deprecated alias for `cursor`, kept working. Pass an ISO `created_at`. Superseded because it published the sort key, which pinned the ordering.

curl -X GET "https://bidandscale.com/api/v1/runs" \
  -H "Authorization: Bearer $BIDANDSCALE_API_KEY"

POST /api/v1/runs

Hand the Ads copilot a brief. Returns 202; poll for the result.

GET /api/v1/runs/{runId}

Poll a run until it reaches a terminal status.