Menu

Runs

1 endpoint in the Mattering Agents API. Service tier only.

GET agents/{public_id}/runs/ Service tier

Read one of the runs by id. derived from route

URL

  • Service tierhttps://agents.mattering.io/api/internal/v1/agents/{public_id}/runs/

Path parameters

NameType
public_idstr

Pagination

Accepts limit and offset. The response meta carries total, limit and offset.

Responses

200 data and meta envelope

{
  "data": [
    {
      "id": "...",
      "trigger": "...",
      "status": "...",
      "started_at": "2026-01-01T00:00:00Z",
      "finished_at": "2026-01-01T00:00:00Z",
      "error_message": "...",
      "tokens_in": "...",
      "cache_read_tokens": "...",
      "cache_create_tokens": "...",
      "tokens_out": "...",
      "cost_cents": 0.0,
      "conversation_id": "...",
      "schedule_id": "..."
    }
  ],
  "meta": {
    "total": 0,
    "limit": 0,
    "offset": 0,
    "has_more": true
  }
}

Field names come from the code; values are placeholders (... is a string, 0 a number, dates are ISO 8601).

Errors

StatusCode
404agent_not_found

Example

curl -X GET "https://agents.mattering.io/api/internal/v1/agents/PUBLIC_ID/runs/" \
  -H "X-Internal-Secret: $MATTERING_INTERNAL_API_SECRET" \
  -H "X-Internal-Org-Id: $ORG_ID" \
  -H "X-Internal-User-Email: you@example.com"

Source: MatterCore/agents_api.py (agents_api.agent_runs)

All Agents resources
Start Free Explore our Products