Get a task run
Get a single task run by id, with its current state.
A succeeded platform task run also carries its outputs by name. Consult the
current task output schema for the names. Older runs preserve the names from
their executed version and may use o0 even when the current schema differs.
Results are null for script task
runs (including all scheduled runs), runs that did not succeed, or when
outputs could not be read just now.
Task runs created by task schedules remain readable when task scheduling is disabled for the organization; scheduling actions such as rerun require it.
The state is refreshed periodically, so it can lag the run by
up to 2 minutes: a run that has already finished may still read as RUNNING
for that long. When polling for completion, allow for this delay.
404: no task run of this id the caller’s organization owns — the same answer whether it never existed or belongs to another organization.
Authorizations
Response
Successful Response
Example of a platform-task (RasterFlow) run: { "taskRunId": "npqy9q19q4wlm3", "taskName": "predict_mosaic_geometries_recipe", "state": "SUCCEEDED", "region": "aws-us-west-2", "submittedAt": "2026-06-04T18:00:00Z", "name": "College Park roofs, 2023", "inputs": { "aoi": "s3://wherobots-examples/rasterflow/aois/collegepark.parquet", "start": "2023-01-01T00:00:00Z", "end": "2024-01-01T00:00:00Z", "model_recipe": "sam3-text-geometry", "text_prompt": ["roofs"], "confidence_threshold": 0.3, "target_crs": "EPSG:3857" }, "startedAt": "2026-06-04T18:01:10Z", "endedAt": null, "durationSeconds": 240, "cached": false, "results": {"vector_results_uri": "s3://.../predictions.parquet"}, "errorMessage": null }
Why a failed or timed-out run failed, when more is known than its failureClass: a short, user-safe reason the caller can act on (for example a configuration rejection such as an unavailable runtime), or, for a run that could not be started, a task run ID to quote to support. Null for cancelled runs and when nothing beyond failureClass is known. REJECTED runs explain their input problems on getTaskRun; their summaries in run lists and schedule history remain null.

