Pipelines /
Run release flow
Required permission
Project > Pipelines > General > Update
Path parameters
projectId
string requiredID of the project
pipelineId
string requiredID of the pipeline
stage
string requiredStage of the pipeline
Request body
- {object}
name
stringThe optional name of the release-flow run.
min length3max length39pattern^[a-zA-Z]((-|\s)?[a-zA-Z0-9]+((-|\s)[a-zA-Z0-9]+)*)?$description
stringThe optional description of the release-flow run.
max length200pattern^[a-zA-Z0-9.,?\s\\/'"()[\];`%^&*\-_:!]+$arguments
{object}A set of arguments that can be referenced in a template using '${args.argumentName}'.
overrides
{object}Overrides for specific reference values. This should be an object where each key corresponds to a ref defined in the template. The values of each of these keys should also be an object, where each key value pair provided will overwrite the value for that key in the given ref. For example, the value
{ 'example-ref': { 'branch': 'devel' } }
would set thebranch
field todevel
for the node with refexample-ref
.releaseNodeOverrides
{object}Overrides for release nodes. This should be an object where each key is the id of a deployment service used in a release node. The value of each of these keys should be also be an object containing the new spec of the release for that deployment service.
POST /v1/projects/{projectId}/pipelines/{pipelineId}/release-flows/{stage}/runs
Example request
curl --header "Content-Type: application/json" \
--header "Authorization: Bearer NORTHFLANK_API_TOKEN" \
--request POST \
--data '{"name":"Example Run","description":"This is a description for the release-flow run.","overrides":{"example-ref":{"branch":"devel"}},"releaseNodeOverrides":{"example-service":{"type":"registry","origin":{"imagePath":"nginx:latest"}}}}' \
https://api.northflank.com/v1/projects/{projectId}/pipelines/{pipelineId}/release-flows/{stage}/runs
Example response
200 OK