---
title: "Get a pipeline execution"
method: GET
path: "/sources/{sourceKey}/v1/pipelines/executions/{pipelineExecutionId}"
tags: ["Pipeline Executions"]
---

# Get a pipeline execution

`GET /sources/{sourceKey}/v1/pipelines/executions/{pipelineExecutionId}`

Get a pipeline execution.

## Path parameters

- `sourceKey` string, required
- `pipelineExecutionId` string, required

## Query parameters

- `withOperationBody` boolean

## Response `200`

Returns the pipeline execution.

- V1PipelineExecution
  - `id` string, required — id to refer for a specific pipeline execution.
  - `pipelineDefinitionId` string, required — The id with version in the format `<id>.<version>`.
  - `status` 'SUCCESSFUL' | 'ERROR' | 'IN_PROGRESS' | 'IN_REVIEW' | 'CANCELLED' | 'DROPPED', required — Status of the pipeline execution. * `SUCCESSFUL`: The pipeline execution completed successfully. Every step of the pipeline was executed successfully and the change has been accepted in the system. * `ERROR`: The pipeline execution failed at a step due to a system error. * `IN_PROGRESS`: The pipeline execution is being processed by the system. * `IN_REVIEW`: The pipeline execution is waiting for a manual action. Refer to the ActOnPipelineExecution endpoint. * `CANCELLED`: The pipeline execution has been short-circuited by the system and never completed. * `DROPPED`: The pipeline execution has been dropped because the change has been rejected by the user following review.
  - `steps` V1PipelineExecutionStep[], required
    - `status` 'PROCESSED' | 'ERROR' | 'IN_PROGRESS' | 'IN_REVIEW' | 'CANCELLED' | 'PENDING' | 'NOT_TRIGGERED', required — Status of the pipeline execution step. * `PROCESSED`: The step has been processed. * `ERROR`: The step has failed due to a system failure. * `IN_PROGRESS`: The step is being processed by the system. * `IN_REVIEW`: The step is waiting for a manual action. Refer to the ActOnPipelineExecution endpoint. * `CANCELLED`: The step has been cancelled. * `PENDING`: The step evaluation has not yet happened. * `NOT_TRIGGERED`: The step was skipped since the step trigger did not trigger.
    - `error` V1Error
      - `code` 400 | 401 | 403 | 404 | 408 | 409 | 413 | 500 | 501, required
      - `message` string, required
      - `type` 'ALREADY_EXISTS' | 'FAILED_PRECONDITION' | 'INTERNAL' | 'INVALID_ARGUMENT' | 'NOT_FOUND' | 'OUT_OF_RANGE' | 'UNIMPLEMENTED' | 'PERMISSION_DENIED' | 'UNAUTHENTICATED' | 'CONTENT_TOO_LARGE' | 'REQUEST_TIMEOUT', required
      - `details` V1Error[] — list of errors that occurred if applicable.
    - `decision` V1PipelineStepDecision — information on who, when, why and what was executed on a manual step.
      - `id` string, required — action id that was used with a manual action.
      - `description` string — optional description on why the action was applied.
      - `author` V1UserInfo, required
        - `id` string, required
        - `email` string, required
      - `actedAt` string, date-time, required — timestamp when the user acted on the step with a manual action.
    - `processedAt` string, date-time — timestamp when the step was processed by the system.
  - `operation` V1PipelineOperation, required
    - `taskId` string, required — The task identifier. Used to track an async task in the system. Use the task ID to poll for completion status. The taskId holds different prefix to represent different tasks. - oneOf task: `s_<id>`. - bulk task: `bk_<id>` (deprecated: `<id>` only). - bundle task: `bd_<id>` (deprecated: `<id>` only). - purge task: `pg_<id>` (deprecated: `purge:<id>`).
    - `action` 'CREATE' | 'UPSERT' | 'DELETE' | 'UPDATE', required — The action to perform.
    - `target` union, required
      - object
        - `targetType` 'RELATIONSHIP' | 'RESOURCE' | 'OBJECT', required
        - `id` string, required — The ID of the resource created, upserted, or deleted.
        - `type` string, required — The type of resource created, upserted, or deleted.
      - object
        - `targetType` 'RELATIONSHIP' | 'RESOURCE' | 'OBJECT', required
        - `id` string, required — The unique identifier of the relationship. This is a key with the shape `{fromID}.{toID}`.
        - `type` string, required — The type of relationship created, upserted, or deleted.
      - object
        - `targetType` 'RELATIONSHIP' | 'RESOURCE' | 'OBJECT', required
        - `id` string, required — The ID of the object created or deleted.
        - `type` string, required — The type of object created or deleted.
    - `body` object — The body of the operation as defined in the original request. * For a DELETE action, this would be empty. * For a CREATE or UPSERT action, this would be the resource or relationship.
  - `processedOperation` V1PipelineOperation
    - `taskId` string, required — The task identifier. Used to track an async task in the system. Use the task ID to poll for completion status. The taskId holds different prefix to represent different tasks. - oneOf task: `s_<id>`. - bulk task: `bk_<id>` (deprecated: `<id>` only). - bundle task: `bd_<id>` (deprecated: `<id>` only). - purge task: `pg_<id>` (deprecated: `purge:<id>`).
    - `action` 'CREATE' | 'UPSERT' | 'DELETE' | 'UPDATE', required — The action to perform.
    - `target` union, required
      - object
        - `targetType` 'RELATIONSHIP' | 'RESOURCE' | 'OBJECT', required
        - `id` string, required — The ID of the resource created, upserted, or deleted.
        - `type` string, required — The type of resource created, upserted, or deleted.
      - object
        - `targetType` 'RELATIONSHIP' | 'RESOURCE' | 'OBJECT', required
        - `id` string, required — The unique identifier of the relationship. This is a key with the shape `{fromID}.{toID}`.
        - `type` string, required — The type of relationship created, upserted, or deleted.
      - object
        - `targetType` 'RELATIONSHIP' | 'RESOURCE' | 'OBJECT', required
        - `id` string, required — The ID of the object created or deleted.
        - `type` string, required — The type of object created or deleted.
    - `body` object — The body of the operation as defined in the original request. * For a DELETE action, this would be empty. * For a CREATE or UPSERT action, this would be the resource or relationship.
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `400` — Returned when the request is malformed or invalid.
- `404` — Returned when the source or pipeline execution does not exist.

---

[API](https://skmtc.dev/clinia/apis/registry-api.md) · [All operations](https://skmtc.dev/clinia/apis/registry-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clinia/registry-api/revisions/3a9197b11351/schema)