Browse runtime sandbox

List entries at a path in the workspace runtime sandbox. Omit path to list the root, or pass depth=-1 (with no path) to fetch the entire repository tree from the configured default branch on GitHub in one call.

GET /context/runtime

Browse runtime sandbox

cURL

curl --request GET \
  --url https://api.getcargo.io/v1/context/runtime \
  --header 'Authorization: Bearer <token>'

200

{
  "path": "<string>",
  "entries": [
    {
      "name": "<string>",
      "path": "<string>"
    }
  ],
  "truncated": true
}

Authorizations

Authorization · string · header · required

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

Query Parameters

path · string

Optional path to browse, relative to the workspace working directory. Omit to list the root.

depth · integer

Recursion depth. Omit (or pass 1) to list a single directory level via the runtime sandbox. Pass -1 together with no path to fetch the entire repository tree from the configured default branch on GitHub in one call.

Required range: -9007199254740991 <= x <= 9007199254740991

Response

200

application/json

Successful response

path · string · required

entries · Entries · object[] · required

Files and folders at the requested path.

Show child attributes

truncated · boolean

Set to true only on the recursive GitHub view when the upstream tree response was truncated past GitHub's 100k-entries / 7 MB cap.