Background Tasks

Runs

The Runs page loads the first 50 cloud runs. Each run on that page failed on a schedule.

get/v1/background-task-runs

Request

Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
URL: /v1/background-task-runs
Auth: HTTP bearer

Query parameters

limitinteger

Example:50

How many runs to return. The Runs page asks for 50.

statusstring

Optional run status filter.

executorstring

Optional cloud or desktop filter.

cursorstring

Cursor from a previous page.

slugstring

Optional workflow filter.

Response

Failed cloud runs.

nextCursorstring nullable

RFC3339 cursor for the next page when more runs are available.

Example response

{
  "nextCursor": "2026-06-04T21:00:30Z",
  "runs": [
    {
      "attempt": 1,
      "completedAt": "2026-06-04T21:02:00Z",
      "createdAt": "2026-06-04T21:00:30Z",
      "errorCode": "llm_call_failed",
      "executor": "api",
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "lastHeartbeatAt": "2026-06-04T21:01:30Z",
      "localRunId": "local-run-42",
      "model": "openai/gpt-4.1-mini",
      "previousRunId": "run-20260604-205000",
      "progressMessage": "Building API-native task artifact.",
      "progressPercent": 50,
      "provider": "openai",
      "requestedContext": "Run this now and focus on high-risk accounts.",
      "revision": 2,
      "runId": "run-20260604-210000",
      "slug": "daily-summary",
      "startedAt": "2026-06-04T21:01:00Z",
      "status": "succeeded",
      "subUseCase": "daily-summary",
      "summary": "No high-priority account changes.",
      "temporalClosedAt": "2026-06-04T21:02:00Z",
      "temporalRunId": "00000000-0000-0000-0000-000000000001",
      "temporalStartedAt": "2026-06-04T21:01:00Z",
      "temporalStatus": "Running",
      "temporalWorkflowId": "background-task/user/daily-summary/api-trigger-123",
      "trigger": "manual",
      "updatedAt": "2026-06-04T21:02:05Z",
      "useCase": "background-task"
    }
  ]
}

Changes

No operation changes recorded.