Skip to main content

Get pipeline

GET 

/platform/pipeline/:pipelineId

Retrieve a pipeline's jobs, configuration and status using the required pipelineId path parameter. Maestro accepts UUIDs with hyphens or underscores and normalizes the identifier before forwarding it to Platform-API.

Example request​

GET /platform/pipeline/1b33ad2f-33d3-4837-9eeb-83c82c8b909d

Response fields​

The documented response wraps the pipeline in data, alongside status. Pipeline fields include id, name, description, cron, customer_id, status, created_at, updated_at and jobs. The pipeline's status can be active, paused or error; do not confuse it with execution status.

Each job includes job_id, job_name, input, output and, where applicable, transformations. Input settings depend on the connector. A null cron represents a pipeline without scheduled execution.

If the pipeline does not exist, the documented 404 response includes detail.exception_type set to PipelineNotFound and detail.data set to null.

Use List pipelines to find pipeline IDs. For connector-specific job configuration, see Get JDBC job or Get Singer job.

Request​

Responses​

Pipeline details