Skip to main content
GET
/
api
/
v1
/
repos
/
files
/
metadata
List Files Metadata
curl --request GET \
  --url https://api.{cluster}.code.storage/api/v1/repos/files/metadata \
  --header 'Authorization: Bearer <token>'
{
  "files": [
    {
      "last_commit_sha": "a1b2c3d4e5f6",
      "mode": "100644",
      "path": "README.md",
      "size": 2048
    }
  ],
  "ref": "main"
}

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.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
ref
string

Optional branch, tag, or commit SHA to list from. When omitted, the repository default branch is used.

​
ephemeral
boolean

Whether ref should be resolved from the ephemeral namespace.

Response

The repository tree plus deduplicated commit metadata for the latest change touching each file.

Files in the repository at the resolved revision, each annotated with the latest commit that changed it.

​
commits
object
required

Commit metadata keyed by last_commit_sha so repeated commits are only sent once.

​
files
object[]
required

Files in the resolved revision, each annotated with the latest commit that changed it.

​
ref
string
required

The resolved ref or commit used to generate the listing.

Example:

"main"