runs

List the runs your team started

Lists the runs your team started, newest first, one numbered page at a time, with the totals of every page. A run is listed when a team member started it, in the Dashboard, through an agent or with an API key, on any tool: the team's own or a public one.

  • Every member sees every run the team started, whoever started it.
  • Filter by integration, status, source and time range, or find one run by its ID.
  • Runs stay listed for 90 days.
  • To follow a run you just started, use jobs.get with its job ID. Use this list to look back over the team's runs.
get/v1/runs

Request

  • Base URL: https://api.pomerado.ai
  • URL: https://api.pomerado.ai/v1/runs
  • Auth: HTTP bearer

Query parameters

integration_idstring
Example:int_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190

an integration ID: int_ and 32 lowercase hex digits

status'queued' | 'running' | 'needs_input' | 'succeeded' | 'failed' | 'cancelled'
source'mcp' | 'api' | 'dashboard' | 'editor'

mcp: an agent over MCP signed in with OAuth. dashboard: a member in the Dashboard. api: an API key, an MCP connection that uses one, or OAuth on the API. editor: a run of a tool's code from the Code editor, code.run, on any of them

fromstring

Accepted at or after, inclusive (default and earliest: 90 days ago)

tostring

Accepted before (default: now)

run_idstring
Example:job_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190

a job ID: job_ and 32 lowercase hex digits

pagestring

The page to read, from 1 (default 1)

limitstring

Runs per page, 1 to 100 (default 20)

Response

One page of the team's runs

pageinteger required

a non-negative number

limitinteger required

a non-negative number

totalinteger required

Runs matching the filters, on every page

Changes

No recorded changes to this operation across all 1 revision of this API.