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

# Update your context settings

> Updates strategy, tier, and the context switch in one transaction.



## OpenAPI

````yaml /api-reference/openapi.json patch /api/me/context
openapi: 3.1.0
info:
  title: Nasiko API
  description: >-
    HTTP API for the Nasiko OpenRuntime: agents, coding harnesses, TokenOps,
    routing, MCP, and secrets. Spec is generated from annotated routes; some
    surfaces are documented on the hand-written pages alongside this file.
  license:
    name: ''
  version: 0.1.0
servers:
  - url: https://free.app.nasiko.com
    description: Nasiko Cloud Free
  - url: https://{workspace}.app.nasiko.com
    description: Nasiko Cloud paid workspace
    variables:
      workspace:
        default: your-workspace
        description: >-
          Your workspace's subdomain, as shown in the connect command on the
          dashboard's Nasiko CLI page
security:
  - bearer_auth: []
tags:
  - name: secrets
    description: Encrypted per-user agent secrets
  - name: catalog
    description: >-
      Agent catalog: registration, discovery, versions, per-agent secrets, and
      source import
  - name: agents
    description: >-
      Agent lifecycle: deployments, LLM routing config, update/rollback,
      upload-and-deploy
  - name: orchestrator
    description: >-
      A2A dispatch: routing-engine/ReAct orchestrator and direct agent chat,
      plus routing stats
  - name: users
    description: >-
      User management: CRUD, roles, credentials, accessible agents
      (superuser-only)
  - name: usage
    description: Per-user token usage and cost reporting
  - name: observability
    description: Sessions, traces, spans, agent logs, and FinOps reporting
  - name: llm-router
    description: LLM routing presets, provider/model catalog, and tier→model registry
  - name: context-selection
    description: >-
      Per-user chat-history selection preferences: strategy, PACMS budget tier,
      the on/off switch, a dry-run preview, and settings-change history
  - name: coding-agents
    description: >-
      The progress local clients report while they bring in the caller's coding
      agents
  - name: settings
    description: >-
      Workspace-wide settings, including the Optimization tiers a user's PACMS
      budget level resolves against
  - name: mcp
    description: >-
      MCP gateway: agent-facing JSON-RPC tool calls, connector
      registration/upload/sharing, credentials & OAuth, and per-agent tool
      permissions
paths:
  /api/me/context:
    patch:
      tags:
        - context-selection
      summary: Update your context settings
      description: Updates strategy, tier, and the context switch in one transaction.
      operationId: update_context
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ContextUpdate'
        required: true
      responses:
        '200':
          description: >-
            Saved; body `{strategy?, level?, enabled?}` — one transaction, full
            state after the write
        '404':
          description: No such user.
        '422':
          description: A value outside an enum (Axum's Json rejection)
      security:
        - bearer_auth: []
components:
  schemas:
    ContextUpdate:
      type: object
      properties:
        enabled:
          type:
            - boolean
            - 'null'
        level:
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/PacmsBudgetLevel'
        strategy:
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/ContextSelectionStrategy'
    PacmsBudgetLevel:
      type: string
      description: >-
        A user's conversation-history tier. The tier names the level the user
        picked. The operator sets how many tokens or items each level means (see
        context tiers), so it can be tuned per deployment.
      enum:
        - low
        - medium
        - high
    ContextSelectionStrategy:
      type: string
      description: A user's conversation-history context-selection strategy.
      enum:
        - pacms
        - topk
        - lastk
  securitySchemes:
    bearer_auth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Session JWT. After `nasiko auth login`, print it with `jq -r
        '.clusters[.active].token' ~/.nasiko/config.json`. API keys aren't
        supported.

````

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