List Runs API

Retrieve runs for your team. You can optionally filter by task_key and page through results with a cursor.

GET /v1/runs/list?task_key={task_key}

Query Parameters

task_key filters runs to a single task.
limit controls page size.
cursor continues from the previous page.

Example

curl -X GET "https://api-ingress-worker-staging.browsable-staging.workers.dev/v1/runs/list?task_key=reddit-search&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "runs": [
    {
      "run_id": "00000000-0000-4000-8000-000000000001",
      "task_key": "reddit-search",
      "task_name": "Reddit Search",
      "run_status": "succeeded",
      "status_url": "/v1/runs/00000000-0000-4000-8000-000000000001",
      "result": {"count": 25, "results": []},
      "error": null,
      "created_at": "2024-01-20T10:30:00Z"
    }
  ],
  "pagination": {
    "has_more": false,
    "next_cursor": null,
    "previous_cursor": null
  }
}