Sign in

v2

OpenAPI 3.0.02026-08-051996591.2 MB
Pipeline Runs

Get pipeline run

Returns details of a pipeline run, including record counts, session keys, and status.

get/v2/pipelines/{pipeline_key}/runs/{run_id}

Path parameters

pipeline_keystring required

The unique key for the pipeline. You can provide the key, or the platform generates one.

Example:sharepoint-legal-ingest

The unique key of the pipeline.

run_idstring required

The unique identifier for a pipeline run.

Example:run_pip_abc_manual_550e8400

The unique identifier of the run.

Headers

Request-Timeoutinteger

The platform makes a best effort to complete the request in the specified seconds, or it times out.

Request-Timeout-Millisinteger

The platform makes a best effort to complete the request in the specified milliseconds, or it times out.

Response

The requested pipeline run.

idstring required

The unique identifier for a pipeline run.

pipeline_keystring required

The unique key for the pipeline. You can provide the key, or the platform generates one.

agent_keystring required

A unique key that identifies an agent.

status'running' | 'completed' | 'failed' | 'cancelled' required

The status of a pipeline run.

trigger_type'scheduled' | 'manual' | 'retry' required

What initiated the pipeline run.

records_fetchedinteger required

Number of records discovered from the source in this run.

records_processedinteger required

Number of records successfully processed by the agent.

records_failedinteger required

Number of records that failed processing.

errorstring nullable

Error details if the run failed.

started_atstring date-time nullable

When the run started executing.

completed_atstring date-time nullable

When the run finished.

created_atstring date-time required

When the run was created.

Example response

{
  "id": "run_pip_abc_manual_550e8400",
  "pipeline_key": "sharepoint-legal-ingest",
  "agent_key": "customer_support"
}