Pipelines

A pipeline is a graph of containers that accomplish some goal. Pipelines are created via a Pipeline configuration file and can be set to be run automatically via attached extensions


List all pipelines

GET/api/namespaces/{namespace_id}/pipelines

Returns the metadata for all pipelines. If you want a more complete picture of the pipeline details combine this endpoint with the configs endpoint to grab the metadata AND the user's pipeline configuration.

Path parameters

NameTypeRequiredDescription
namespace_idstringyesThe unique identifier for the target namespace.

Responses

StatusBodyDescription
200ListPipelinesResponsesuccessful operation
4XXErrorError
5XXErrorError

Get pipeline by id

GET/api/namespaces/{namespace_id}/pipelines/{pipeline_id}

Path parameters

NameTypeRequiredDescription
namespace_idstringyesThe unique identifier for the target namespace.
pipeline_idstringyesThe unique identifier for the target pipeline.

Responses

StatusBodyDescription
200GetPipelineResponsesuccessful operation
4XXErrorError
5XXErrorError

Update a pipeline's state

PATCH/api/namespaces/{namespace_id}/pipelines/{pipeline_id}

Path parameters

NameTypeRequiredDescription
namespace_idstringyesThe unique identifier for the target namespace.
pipeline_idstringyesThe unique identifier for the target pipeline.

Request body (required): UpdatePipelineRequest

Responses

StatusBodyDescription
204noneresource updated
4XXErrorError
5XXErrorError

Delete pipeline by id

DELETE/api/namespaces/{namespace_id}/pipelines/{pipeline_id}

IMPORTANT: Deleting a pipeline is set to cascade. All downstream objects to the pipeline (configs, secrets, runs, tasks) will be removed as well.

Path parameters

NameTypeRequiredDescription
namespace_idstringyesThe unique identifier for the target namespace.
pipeline_idstringyesThe unique identifier for the target pipeline.

Responses

StatusBodyDescription
204nonesuccessful deletion
4XXErrorError
5XXErrorError