Skip to main content
POST
Revert Release Status (Admin Only)
This endpoint requires authentication. Include your Bearer token in the Authorization header.

Description

This endpoint allows admins to revert a release status. Primarily used to revert failed auto-creation releases back to submitted status or completed releases back to draft. Allowed Status Reversions:
  • Approved (with failed auto-creation) → Submitted
  • Completed → Draft
Note: This action clears all auto-creation artifacts and creates an audit trail. Authorization:
  • Required role: admin or higher

Code Examples

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Path Parameters

id
string<uuid>
required

Release ID

Body

application/json
targetStatus
enum<string>
required

Target status to revert to

Available options:
submitted,
draft
reason
string
required

Reason for status reversion (required for audit trail)

Minimum string length: 1

Response

Success

success
boolean
Example:

true

message
string
Example:

"Release status reverted to \"submitted\" successfully"

data
object