MOmosaic
Pipeline Observability

Get Run Progress

Read whole-run tile counts plus one bounded page of tiles, each with at most five recent tasks. Counts and completed_node_percent cover the entire run, not only the page. Use tasks for complete task evidence. Progress is not an ETA.

get/agent_run/{run_id}/progress

Request

  • Base URL
    https://api.mosaic.so
  • URL
    https://api.mosaic.so/agent_run/{run_id}/progress
  • Auth
    HTTP bearer

Path parameters

run_idstring uuid required

run id UUID.

Query parameters

limitinteger

Page size from 1 to 100; default 25. Progress and notification configuration pages count tiles.

cursorstring

Opaque next_cursor from the previous page. Pass verbatim and preserve the original filters. Do not decode or construct it.

fromstring date-time

Inclusive ISO 8601 lower bound on creation time.

tostring date-time

Inclusive ISO 8601 upper bound on creation time.

updated_fromstring date-time

Inclusive ISO 8601 update watermark. Restart pagination on each poll and fetch every page before advancing it.

workspace_idstring uuid

Optional workspace UUID within the key organization. Must match X-Workspace-Id when both are supplied.

Headers

X-Workspace-Idstring uuid

Restrict requests to an authorized workspace UUID. Omit to query the organization.

Response

Current organization-scoped evidence.

run_idstring uuid required

Run ID.

agent_idstring uuid nullable required

Originating agent.

statusstring required

Persisted run status.

status_messagestring nullable required

Run status details.

started_atstring date-time required

Run creation time.

updated_atstring date-time nullable required

Run-row update time; not a watermark for all tile/task changes.

triggered_byobject nullable required

Source metadata used to start this run.

node_status_countsobject required

Counts for the entire run, independent of node pagination. Includes total, completed, in_progress, failed, cancelled, skipped, not_started, and other persisted statuses such as running.

completed_node_percentinteger required

Rounded completed tiles / all tiles × 100. Not elapsed-time progress or an ETA; failures/skips may prevent 100.

next_cursorstring nullable required

Pass verbatim to fetch the next node page; null when finished.

tasks_snapshot_limit5 required

Maximum embedded tasks per tile.

Changes

No recorded changes to this operation across all 1 revision of this API.