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.

Retrieve tags in a repository with pagination.
GET /api/v1/repos/tags?cursor=CURSOR&limit=20
Authorization: Bearer YOUR_JWT_TOKEN

Parameters

cursor
string
Pagination cursor from previous response
limit
string
Maximum number of tags to return (default: 20)

JWT Requirements

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

Response

{
  "tags": [
    {
      "cursor": "t_abc123",
      "name": "v1.0.0",
      "sha": "a1b2c3d4e5f6..."
    },
    {
      "cursor": "t_def456",
      "name": "v2.0.0",
      "sha": "f6e5d4c3b2a1..."
    }
  ],
  "next_cursor": "t_def456",
  "has_more": true
}

Notes

  • Tags are sorted by name in lexical order
  • The sha field is the dereferenced commit SHA — for annotated tags this is the commit the tag points to, not the tag object itself
  • Internal tags (used by the platform) are filtered from results

Error Responses

401 Unauthorized
string
Invalid JWT or missing authorization header