> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getcargo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.



## OpenAPI

````yaml https://api.getcargo.io/openapi.json get /context/runtime
openapi: 3.1.0
info:
  title: Cargo API
  version: 1.0.0
  description: Cargo Platform API v1
servers:
  - url: https://api.getcargo.io/v1
    description: Cargo API
security:
  - bearerAuth: []
paths:
  /context/runtime:
    get:
      tags:
        - Context - Runtime
      summary: Browse runtime sandbox
      description: >-
        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.
      parameters:
        - in: query
          name: path
          schema:
            title: Path
            description: >-
              Optional path to browse, relative to the workspace working
              directory. Omit to list the root.
            type: string
          description: >-
            Optional path to browse, relative to the workspace working
            directory. Omit to list the root.
        - in: query
          name: depth
          schema:
            title: Depth
            description: >-
              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.
            type: integer
            minimum: -9007199254740991
            maximum: 9007199254740991
          description: >-
            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.
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  path:
                    type: string
                    title: Path
                  entries:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                          title: Name
                        path:
                          type: string
                          title: Path
                          description: >-
                            Repository-relative path. For single-level browses
                            this is `${parent}/${name}`; for the recursive
                            GitHub view it is the full path returned by the
                            Trees API.
                        kind:
                          type: string
                          enum:
                            - file
                            - folder
                          title: Kind
                      required:
                        - name
                        - path
                        - kind
                      additionalProperties: false
                    title: Entries
                    description: Files and folders at the requested path.
                  truncated:
                    title: Truncated
                    description: >-
                      Set to `true` only on the recursive GitHub view when the
                      upstream tree response was truncated past GitHub's
                      100k-entries / 7 MB cap.
                    type: boolean
                required:
                  - path
                  - entries
                additionalProperties: false
        '400':
          description: Bad request
        '401':
          description: Unauthorized
        '404':
          description: Not found
        '500':
          description: Internal server error
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````