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 claim
  • Requires the repo:write scope

Response

{
  "repo_id": "V1StGXR8_Z5jdHi6B-myT",
  "message": "Repository V1StGXR8_Z5jdHi6B-myT 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
409 ConflictRepository was already deleted
400 Bad RequestRepository claim missing from auth context
500 Internal Server ErrorDatabase or event publishing errors