Skip to content

Retry Deployment

POST
/api/deployments/{deployment_id}/retry

Retry a failed deployment.

Allowed only when the current status is FAILED. If retry_count has already reached 5 (the hard cap), the request is rejected with 422 ‘Max retries exceeded’.

On success resets the deployment to a fresh PENDING state:

  • status = PENDING
  • retry_count += 1
  • error_message = NULL
  • started_at = NULL
  • completed_at = NULL

Returns: 204 No Content on success.

Raises: HTTPException 404 if the deployment is not found or not owned by org. HTTPException 422 if the deployment status is not FAILED. HTTPException 422 if retry_count >= 5 (max retries exceeded).

Authorizations

Parameters

Path Parameters

deployment_id
required
string format: uuid

Query Parameters

organization_id
required
string format: uuid

Responses

204

Successful Response

422

Validation Error

object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string