POST/v1/project-releases

Create a project release

Creates a project release using a Git release, project release, or rollback configuration. Provide the fields required for the selected type; project releases require targetProjectId, while rollbacks require projectReleaseId.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

6 body fields

Project release configuration. Required fields depend on the selected release type.

descriptionstringoptional
namestringrequired
projectIdstringrequired
projectReleaseIdstringrequired
selectedFlowsIdsarray<string>optional
typestringrequired
Allowed:ROLLBACK

1 status code
201Returns the created project release, including its identifier, project, name, file identifier, type, and timestamps.
createdstringrequired
descriptionstringoptional
fileIdstringrequired
idstringrequired
importedBystringoptional
importedByUserobjectoptional
namestringrequired
projectIdstringrequired
typestringrequired
Allowed:GITPROJECTROLLBACK
updatedstringrequired

Error handling

type, name, and projectId are required for each release configuration. Set type to GIT, PROJECT, or ROLLBACK; PROJECT also requires targetProjectId, and ROLLBACK also requires projectReleaseId.