List Files

GET

api

repos

files

List Files

curl --request GET \
  --url https://api.{cluster}.code.storage/api/v1/repos/files \
  --header 'Authorization: Bearer <token>'

{
  "paths": [
    "README.md"
  ],
  "ref": "main"
}

Authorization

string

header

required

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

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.

File paths for the resolved revision.

Files in the repository at the resolved revision.

paths

string[]

required

Array of file paths in the repository.

Repository-relative path used to scope the operation.

Example:

["README.md"]

ref

string

required

The resolved reference (branch name or commit SHA) that was used.

Example:

"main"

List Files

curl --request GET \
  --url https://api.{cluster}.code.storage/api/v1/repos/files \
  --header 'Authorization: Bearer <token>'

{
  "paths": [
    "README.md"
  ],
  "ref": "main"
}

Documentation Index