List the runs your team started
curl --request GET \
--url https://api.pomerado.ai/v1/runs \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.pomerado.ai/v1/runs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.pomerado.ai/v1/runs"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "<string>",
"status": "queued",
"tool_id": "<string>",
"tool_name": "<string>",
"integration_id": "<string>",
"integration_name": "<string>",
"effect": "read",
"write_status": "not_attempted",
"source": "mcp",
"started_by": {
"member_id": "<string>",
"name": "<string>",
"email": "<string>",
"api_key": {
"id": "<string>",
"name": "<string>"
}
},
"login_id": "<string>",
"revision": {
"id": "<string>",
"published_at": "<string>"
},
"attempts": 1,
"created_at": "<string>",
"started_at": "<string>",
"completed_at": "<string>",
"duration_ms": 1
}
],
"page": 1,
"limit": 1,
"total": 1,
"summary": {
"succeeded": 1,
"failed": 1,
"cancelled": 1,
"in_progress": 1,
"median_duration_ms": 1
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}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.
GET
/
v1
/
runs
List the runs your team started
curl --request GET \
--url https://api.pomerado.ai/v1/runs \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.pomerado.ai/v1/runs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.pomerado.ai/v1/runs"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "<string>",
"status": "queued",
"tool_id": "<string>",
"tool_name": "<string>",
"integration_id": "<string>",
"integration_name": "<string>",
"effect": "read",
"write_status": "not_attempted",
"source": "mcp",
"started_by": {
"member_id": "<string>",
"name": "<string>",
"email": "<string>",
"api_key": {
"id": "<string>",
"name": "<string>"
}
},
"login_id": "<string>",
"revision": {
"id": "<string>",
"published_at": "<string>"
},
"attempts": 1,
"created_at": "<string>",
"started_at": "<string>",
"completed_at": "<string>",
"duration_ms": 1
}
],
"page": 1,
"limit": 1,
"total": 1,
"summary": {
"succeeded": 1,
"failed": 1,
"cancelled": 1,
"in_progress": 1,
"median_duration_ms": 1
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}Details
Details
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.
- Callers: an MCP OAuth token or a Dashboard session.
-
Permission:
jobs:read. - Effect: Changes nothing.
-
Errors:
business_account_required, and the errors any request can get.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
an integration ID: int_ and 32 lowercase hex digits
Example:
"int_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190"
Available options:
queued, running, needs_input, succeeded, failed, cancelled 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
Available options:
mcp, api, dashboard Accepted at or after, inclusive (default and earliest: 90 days ago)
Accepted before (default: now)
a job ID: job_ and 32 lowercase hex digits
Example:
"job_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190"
The page to read, from 1 (default 1)
Runs per page, 1 to 100 (default 20)
Response
One page of the team's runs