Skip to main content
Permanently deletes a repository and all its contents. 
DELETE /api/v1/repos/delete
Authorization: Bearer YOUR_JWT_TOKEN

​
Request Body

No request body is required. The repository to delete is determined from the authentication token.

​
JWT Requirements

  • The JWT must include the repository in the repo_url claim
  • Requires the repo:write scope

​
Response

{
  "repo_id": "team/project-alpha",
  "message": "Repository team/project-alpha deletion initiated. Physical storage cleanup will complete asynchronously."
}

​
Error Responses

StatusDescription
401 UnauthorizedNo authorization header provided
403 ForbiddenMissing repo:write scope
404 Not FoundRepository doesn’t exist or was already deleted
400 Bad RequestRepository claim missing from auth context
500 Internal Server ErrorDatabase or event publishing errors