Skip to main content

Documentation Index

Fetch the complete documentation index at: https://code.storage/docs/llms.txt

Use this file to discover all available pages before exploring further.

Delete a tag from the repository. Works with both lightweight and annotated tags.
DELETE /api/v1/repos/tags
Authorization: Bearer YOUR_JWT_TOKEN
Content-Type: application/json

{
  "name": "v1.0.0"
}

Request Body

name
string
required
Tag name to delete (e.g. v1.0.0). Must not start with refs/.

JWT Requirements

  • The JWT must include the repository in the repo claim
  • Requires both git:read and git:write scopes

Response

{
  "name": "v1.0.0",
  "message": "tag deleted"
}

Notes

  • Works with both lightweight and annotated tags. The API resolves the correct ref value internally.
  • If the repository is synced to GitHub, tag deletion triggers a sync automatically.

Error Responses

400 Bad Request
string
Invalid tag name or missing required fields
401 Unauthorized
string
Invalid JWT or missing authorization header
403 Forbidden
string
Missing required scopes
404 Not Found
string
Tag does not exist