To ensure there can always be an active deployment, you can only delete an inactive deployment. Anyone with repo or repo_deployment scopes can delete an inactive deployment.
To set a deployment as inactive, you must:
For more information, see "Create a deployment" and "Create a deployment status."
DELETE /repos/:owner/:repo/deployments/:deployment_id
Status: 204 No Content