Background Tasks

Poll task run status

Returns a compact polling payload for one run. Clients should poll this Solomon AI API endpoint rather than Temporal directly.

get/v1/background-tasks/{slug}/runs/{runId}/status

Request

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

Path parameters

slugstring required

Task slug.

Example:daily-summary

Background task slug, matching bg-tasks/<slug> locally.

runIdstring required

Run id.

Example:run-20260604-210000

Cloud-visible run id for a background task run.

Response

Compact run status.

completedAtstring date-time nullable

Run completion timestamp.

errorstring nullable

Terminal error, when present.

executor'desktop' | 'api' required

Execution backend.

lastHeartbeatAtstring date-time nullable

Latest worker heartbeat/progress timestamp.

progressMessagestring nullable

Progress message.

progressPercentinteger nullable

Best-known progress for polling clients.

revisioninteger required

Current run revision.

runIdstring required

Cloud-visible run id.

slugstring required

Task slug.

startedAtstring date-time nullable

Run start timestamp.

status'queued' | 'running' | 'succeeded' | 'failed' | 'stopped' required

Lifecycle/status slug. Subscription rows use billing states; background task runs use queued/running/succeeded/failed/stopped.

temporalRunIdstring nullable

Temporal run id for API-worker runs.

temporalStatusstring nullable

Last mirrored Temporal status.

temporalWorkflowIdstring nullable

Temporal workflow id for API-worker runs.

Example response

{
  "completedAt": "2026-06-04T21:02:00Z",
  "executor": "api",
  "lastHeartbeatAt": "2026-06-04T21:01:30Z",
  "progressMessage": "Building API-native task artifact.",
  "progressPercent": 50,
  "revision": 2,
  "runId": "api-trigger-4a31958c-3a0a-4cb2-9361-ea563cd0477b",
  "slug": "daily-summary",
  "startedAt": "2026-06-04T21:01:00Z",
  "status": "active",
  "temporalRunId": "00000000-0000-0000-0000-000000000001",
  "temporalStatus": "Running",
  "temporalWorkflowId": "background-task/user/daily-summary/api-trigger-123"
}

Changes

No operation changes recorded.