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

# Context Library

> The server checks current session access and resource permissions on every request. Acceptance does not prove provider execution.

This uses Navigator’s existing encrypted file library. It does not create another file store.

1. Begin an upload with `PUT /v3/context/{fileId}` and per-file encryption metadata.
2. Upload the encrypted bytes to the returned URL, then call `POST /v3/context/{fileId}/complete`. The server verifies the upload before accepting it.
3. Change the name or tags with `PATCH /v3/context/{fileId}`.
4. Read content with `GET /v3/context/{fileId}/content` or delete it with `DELETE /v3/context/{fileId}`.

Keep encryption keys and content out of logs and analytics. Library access does not make an item visible to agents. [Attach selected context](https://darwin.so/docs/reference/sessions/attach.md) to a session explicitly.


## OpenAPI

````yaml openapi-v3.json GET /v3/context
openapi: 3.1.0
info:
  title: Navigator
  version: 3.0.0
servers:
  - url: https://api.darwin.so/api
security: []
paths:
  /v3/context:
    get:
      tags:
        - Sessions
      summary: List Context Library
      description: >-
        The server checks current session access and resource permissions on
        every request. Acceptance does not prove provider execution.
      operationId: list_context
      parameters: []
      responses:
        '200':
          description: Accepted state.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
        '400':
          description: Invalid request.
        '401':
          description: Authentication required.
        '403':
          description: Current access or resource authority denied.
        '404':
          description: Not found.
        '409':
          description: Idempotency or revision conflict.
        '429':
          description: >-
            Request rate or guest session allowance exceeded. The error code
            distinguishes message, operation, agent and concurrency limits.
        '503':
          description: Service unavailable.
      security:
        - apiKey: []
        - bearer: []
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
    bearer:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.