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

401 Unauthorized
string
No authorization header provided
403 Forbidden
string
Missing repo:write scope
404 Not Found
string
Repository doesn’t exist
409 Conflict
string
Repository was already deleted
400 Bad Request
string
Repository claim missing from auth context
500 Internal Server Error
string
Database or event publishing errors