Error
A valid request URL is required to generate request examples{
"success": true,
"releaseId": "<string>",
"statusUrl": "<string>",
"reused": true,
"status": "<string>",
"version": "<string>",
"requeued": true
}{
"success": true,
"releaseId": "<string>",
"jobId": "<string>",
"statusUrl": "<string>"
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": null,
"retryable": true,
"requestId": "<string>"
}
}{
"error": "<string>"
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": null,
"retryable": true,
"requestId": "<string>"
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": null,
"retryable": true,
"requestId": "<string>"
}
}{
"error": "<string>"
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": null,
"retryable": true,
"requestId": "<string>"
}
}Create release
Build an immutable release from a project snapshot or a Git source. The build runs asynchronously.
POST
/
api
/
cicd
/
v1
/
projects
/
{projectId}
/
releases
Error
A valid request URL is required to generate request examples{
"success": true,
"releaseId": "<string>",
"statusUrl": "<string>",
"reused": true,
"status": "<string>",
"version": "<string>",
"requeued": true
}{
"success": true,
"releaseId": "<string>",
"jobId": "<string>",
"statusUrl": "<string>"
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": null,
"retryable": true,
"requestId": "<string>"
}
}{
"error": "<string>"
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": null,
"retryable": true,
"requestId": "<string>"
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": null,
"retryable": true,
"requestId": "<string>"
}
}{
"error": "<string>"
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": null,
"retryable": true,
"requestId": "<string>"
}
}.ablenc bundle. The response returns a releaseId and a statusUrl. Poll Get release until the status is ready.
Set source.kind to choose the content source. Use project_snapshot to capture the project’s current content without a Git integration. Use git, or omit the field, to build from a branch, tag, or commit. The build is independent of the environment. It needs the cicd.release.create scope and project membership, but not environment authority. If an identical versioned release exists, the API reuses it and returns 200 with reused: true. It can requeue a failed build and then sets requeued: true. Otherwise it returns 202 with releaseId, jobId, and statusUrl.
The optional version field sets a release label in the format X.Y.Z when versioning is enabled. The optional lob and developer fields add a line-of-business tag and an attribution.
The API returns these errors:
409 RELEASE_VERSION_CONFLICT: The version exists with different content.409 RELEASE_SOURCE_EXPIRED: A failed snapshot source expired.409 AGENTIC_DRAFT_NOT_ACKNOWLEDGED: You requestedproject_snapshotwhile the draft holds an unacknowledged agentic state.503 PROJECT_SNAPSHOT_UNAVAILABLEor503 AGENTIC_HOLD_UNAVAILABLE: The service is temporarily unavailable. You can retry.503 RELEASE_STORAGE_NOT_SHARED: This deployment can’t build aproject_snapshot. Don’t retry.
Authorizations
Body
application/json
Was this page helpful?