Read a pipeline

Returns a pipeline with all its actions, in order.

Last updated:

Returns a pipeline with all its actions, in order.

GET /api/v1/pipelines/{pipelineId}

Authorization

Requires a signed-in person with this scope: pipelines:read.

Parameters

NameInRequiredTypeDescription
X-Workspace-Idheaderyesstring (uuid)The workspace the call acts in. Take it from the workspace list.
pipelineIdpathyesstring (uuid)The pipeline's id.

Responses

200

The pipeline.

FieldTypeRequiredDescription
idstring (uuid)yes
namestringyes
descriptionstringyes
statusone of DRAFT, VALID, INVALIDyes
statusReasonstringno
schedulestringyes
createdBystringyes
createdAtstring (date-time)yes
updatedAtstring (date-time)yes
actionslist of objectyes
actions[].idstring (uuid)yes
actions[].typeone of COPY, DELETE, TRANSFORM, SCRIPT, EXPORT, IMPORTyes
actions[].writeStrategyone of INSERT, MERGE, CLEANno
actions[].sequenceIndexintegeryes
actions[].sourceEnvironmentIdstring (uuid)no
actions[].targetEnvironmentIdstring (uuid)yes
actions[].statusone of VALID, INCOMPLETE, INVALIDyes
actions[].entitySelectionslist of objectyes
actions[].entitySelections[].selectionIdstringno
actions[].entitySelections[].entityIdentifierstringno
actions[].entitySelections[].entityNamestringno
actions[].entitySelections[].entityDisplayNamestringno
actions[].entitySelections[].filterExpressionstringno
actions[].entitySelections[].transformationslist of objectno
actions[].entitySelections[].transformations[].fieldIdentifierstringno
actions[].entitySelections[].transformations[].fieldNamestringno
actions[].entitySelections[].transformations[].fieldTypestringno
actions[].entitySelections[].transformations[].typestringno
actions[].entitySelections[].transformations[].parametersobjectno
actions[].entitySelections[].transformations[].orderIndexintegerno
actions[].entitySelections[].keyAttributeslist of stringno
actions[].entitySelections[].writeStrategyone of INSERT, MERGE, CLEANno
actions[].entitySelections[].moduleIdentifierstringno
actions[].entitySelections[].moduleNamestringno
actions[].entitySelections[].fieldslist of objectno
actions[].entitySelections[].fields[].identifierstringno
actions[].entitySelections[].fields[].namestringno
actions[].entitySelections[].fields[].typestringno
actions[].entitySelections[].fields[].typeDescriptorstringno
actions[].configobjectyes
actions[].connectorNamestringnoDisplay name of the workspace connector an Export writes through, beside its id in config. Null when the action references no connector or that connector was deleted.

Example response:

{
  "id": "3a1b2c3d-4e5f-6071-8293-a4b5c6d7e8f9",
  "name": "Nightly customer sync",
  "description": "Copies customer records from Production to Staging every night.",
  "status": "VALID",
  "schedule": "0 2 * * *",
  "createdBy": "alex.morgan@example.com",
  "createdAt": "2026-10-12T09:00:00Z",
  "updatedAt": "2026-10-12T09:05:00Z",
  "actions": [
    {
      "id": "4b2c3d4e-5f60-7182-93a4-b5c6d7e8f9a0",
      "type": "COPY",
      "writeStrategy": "MERGE",
      "sequenceIndex": 0,
      "sourceEnvironmentId": "2f8b1c6a-9d3e-4f5a-8b7c-1e2d3f4a5b6c",
      "targetEnvironmentId": "5c3d4e5f-6071-8293-a4b5-c6d7e8f9a0b1",
      "status": "VALID",
      "entitySelections": [],
      "config": {}
    }
  ]
}

400

A path id is not even syntactically a valid id (not a well-formed UUID) — distinct from 404, which means a well-formed id that simply does not exist.

FieldTypeRequiredDescription
messagestringyes
statusintegeryes
errorCodestringyes
timestampstring (date-time)no
pathstringno
detailsobjectno

403

The pipeline references an environment the caller cannot see.

FieldTypeRequiredDescription
messagestringyes
statusintegeryes
errorCodestringyes
timestampstring (date-time)no
pathstringno
detailsobjectno

404

There is no such pipeline.

FieldTypeRequiredDescription
messagestringyes
statusintegeryes
errorCodestringyes
timestampstring (date-time)no
pathstringno
detailsobjectno