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:
Note: This action clears all auto-creation artifacts and creates an audit trail.
curl --request POST \
--url https://server26-dot-royalti-project.uc.r.appspot.com/releases/{id}/revert-status \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"targetStatus": "submitted",
"reason": "Auto-creation failed due to missing artist metadata. Reverting for re-review after corrections."
}'
{
"success": true,
"message": "Release status reverted to \"submitted\" successfully",
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"status": "submitted",
"previousStatus": "approved",
"reason": "Auto-creation failed due to missing artist metadata"
}
}
JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"
Release ID
Success
The response is of type object
.
curl --request POST \
--url https://server26-dot-royalti-project.uc.r.appspot.com/releases/{id}/revert-status \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"targetStatus": "submitted",
"reason": "Auto-creation failed due to missing artist metadata. Reverting for re-review after corrections."
}'
{
"success": true,
"message": "Release status reverted to \"submitted\" successfully",
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"status": "submitted",
"previousStatus": "approved",
"reason": "Auto-creation failed due to missing artist metadata"
}
}