Skip to main content
GET
/
api
/
repos
/
{repo_name}
/
files
/
metadata
List Files with Metadata
curl --request GET \
  --url https://api.{cluster}.code.storage/api/repos/{repo_name}/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.

Path Parameters

​
repo_name
string
required

Repository name. Names that contain / or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example pierre/example is sent as pierre%2Fexample. Plain names such as example can be sent as-is. The server URL-decodes the value before resolving the repository.

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"