Delete a pipeline

Deletes a pipeline and all its actions. Requires the change-pipeline right on every environment the pipeline references.

Last updated:

Deletes a pipeline and all its actions. Requires the change-pipeline right on every environment the pipeline references.

DELETE /api/v1/pipelines/{pipelineId}

Authorization

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

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

204

The pipeline is deleted.

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 caller lacks the change-pipeline right on a referenced environment.

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