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.

Create a lightweight tag pointing to a specific commit. 
POST /api/v1/repos/tags
Authorization: Bearer YOUR_JWT_TOKEN
Content-Type: application/json

{
  "name": "v1.0.0",
  "target": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2"
}

​
Request Body

​
name
string
required
Tag name (e.g. v1.0.0). Must not start with refs/ and must be a valid git ref name.
​
target
string
required
Full 40-character lowercase hex commit SHA the tag should point to.

​
JWT Requirements

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

​
Response

{
  "name": "v1.0.0",
  "sha": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
  "message": "tag created"
}

​
Notes

  • Creates a lightweight tag (not an annotated tag). To create annotated tags, use git push over HTTPS with an authenticated remote URL.
  • If the repository is synced to GitHub, tag creation triggers a sync automatically.

​
Error Responses

​
400 Bad Request
string
Invalid tag name, invalid target SHA format, or missing required fields
​
401 Unauthorized
string
Invalid JWT or missing authorization header
​
403 Forbidden
string
Missing git:write scope
​
409 Conflict
string
A tag with that name already exists