Get Pipeline Status
replicate_pipeline_statusPoll the status of a running pipeline to check progress and see whether each step completed, failed, or is still pending.
Instructions
Poll the status of a pipeline started with replicate_pipeline_start.
Args:
pipeline_id (string): Pipeline ID returned by replicate_pipeline_start.
include_outputs (boolean, default true): Include full PredictionResult per step. Set false for a counts-only summary while the pipeline is running.
Returns structuredContent: { pipeline_id, overall_status, total, succeeded, failed, skipped, running, pending, created_at, expires_at, steps: [{ id, model, status, prediction_id, result?, error?, skip_reason?, started_at, completed_at }] }
overall_status: "running" — steps still executing "completed" — all steps succeeded "partial" — all done, at least one failed or was skipped (failed dependency or budget error)
Note: pipeline-level errors (cycle detected, unknown depends_on) are rejected at replicate_pipeline_start with an error response — they never produce a pollable pipeline.
Tip: Poll every 10–30 seconds until overall_status is "completed" or "partial".
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pipeline_id | Yes | Pipeline ID returned by replicate_pipeline_start. | |
| include_outputs | No | Include full PredictionResult per step. Set false for counts-only summary while pipeline is running. Default: true. |