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

# Routes index

> Server route catalog for health, execute, streaming, file transfer, session lifecycle, and auth management endpoints.

Use these endpoint pages for complete contracts and interactive API playground usage.

## Endpoint catalog

<CardGroup cols={2}>
  <Card title="GET /health" icon="heart-pulse" href="/server/get-health">
    Liveness + server version, no auth required.
  </Card>

  <Card title="POST /execute" icon="terminal" href="/server/post-execute">
    Execute code and return the full result payload.
  </Card>

  <Card title="POST /execute/stream" icon="activity" href="/server/post-execute-stream">
    Stream stdout/stderr/exit as Server-Sent Events.
  </Card>

  <Card title="GET /execute/ws" icon="plug" href="/server/get-execute-ws">
    Stream execution over WebSocket with bidirectional messaging.
  </Card>

  <Card title="POST /file" icon="upload" href="/server/post-file">
    Upload base64 content to a persistent session container.
  </Card>

  <Card title="GET /file" icon="download" href="/server/get-file">
    Download base64 content from a persistent session container.
  </Card>

  <Card title="GET /sessions" icon="list" href="/server/get-sessions">
    List all active persistent sessions.
  </Card>

  <Card title="DELETE /session/:id" icon="trash" href="/server/delete-session">
    Destroy a persistent session and release resources.
  </Card>

  <Card title="POST /cleanup" icon="broom" href="/server/post-cleanup">
    Trigger authenticated server-side cleanup for sessions, containers, and optional images.
  </Card>
</CardGroup>

## Auth & key management

These endpoints require the **master key** and are only available when DB-backed auth is enabled (`--auth-db`).

<CardGroup cols={2}>
  <Card title="POST /auth/keys" icon="key" href="/server/post-auth-keys">
    Create a new API key with optional tenant scoping and TTL.
  </Card>

  <Card title="GET /auth/keys" icon="list" href="/server/get-auth-keys">
    List all API keys, optionally filtered by tenant.
  </Card>

  <Card title="DELETE /auth/keys/:id" icon="ban" href="/server/delete-auth-keys">
    Revoke an API key by ID.
  </Card>

  <Card title="POST /auth/login" icon="right-to-bracket" href="/server/post-auth-login">
    Exchange master key for a short-lived token.
  </Card>
</CardGroup>

## Auth rules

* `GET /health` is public.
* All other endpoints require `Authorization: Bearer <api-key>`.
* Auth endpoints (`/auth/*`) additionally require the **master key**.

## Related pages

<CardGroup cols={2}>
  <Card title="Server overview" icon="server" href="/server/overview">
    Architecture, defaults, and auto-pruning behavior.
  </Card>

  <Card title="Remote server and client" icon="server" href="/remote">
    End-to-end remote usage with CLI and SDK.
  </Card>
</CardGroup>