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

# Apply secrets

> Apply selected vault secrets to an existing Linux computer.

Send `{"names":["ANTHROPIC_API_KEY"]}` to apply those names from your vault to a running Linux computer. Workspace values take precedence over account values. This requires write access to the computer's workspace.

The response contains `success`, `names`, and `restart_required: true`. Open a new terminal or restart the agent to load the updated environment. Existing processes keep their current environment. Applications using their own credential files may need to be configured separately.

A missing secret returns `404`; a computer that is not running returns `409`; a different operating system returns `422`. Secret values are never included in the response.

Saving or deleting a vault entry does not automatically change computers already running. Deleting a vault entry also does not erase a copy previously installed on a computer.


## OpenAPI

````yaml POST /computers/{id}/secrets/sync
openapi: 3.1.0
info:
  title: Orgo API
  description: >-
    Launch cloud computers that AI agents can control and interact with. Create
    workspaces, provision computers, and control them programmatically.
  version: 2.0.0
  contact:
    name: Orgo Support
    email: spencer@orgo.ai
    url: https://orgo.ai
servers:
  - url: https://www.orgo.ai/api
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Workspaces
    description: Organize computers into named workspaces
  - name: Computers
    description: Provision and manage virtual computers
  - name: Computer Lifecycle
    description: Start, stop, and restart computers
  - name: Computer Actions
    description: Control mouse, keyboard, and execute commands
  - name: Screens
    description: >-
      More than one desktop on a single computer. Each screen is its own X
      server with its own cursor and window manager, so an agent working on one
      cannot disturb another.
  - name: Files
    description: Upload and download files
  - name: Templates
    description: Author, build, and launch reproducible computers from templates
paths:
  /computers/{id}/secrets/sync:
    post:
      tags:
        - Computers
      summary: Apply secrets to a computer
      operationId: applyComputerSecrets
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: Computer UUID or instance ID.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - names
              properties:
                names:
                  type: array
                  minItems: 1
                  maxItems: 50
                  items:
                    type: string
      responses:
        '200':
          description: >-
            Secrets applied to a running Linux computer. Open a new terminal or
            restart its agent to read the new environment. Values are never
            returned.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  names:
                    type: array
                    items:
                      type: string
                  restart_required:
                    type: boolean
                  message:
                    type: string
        '400':
          description: >-
            Request could not be completed. The response includes error and may
            include code.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
        '401':
          description: >-
            Request could not be completed. The response includes error and may
            include code.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
        '403':
          description: >-
            Request could not be completed. The response includes error and may
            include code.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
        '404':
          description: >-
            Request could not be completed. The response includes error and may
            include code.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
        '409':
          description: >-
            Request could not be completed. The response includes error and may
            include code.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
        '422':
          description: >-
            Request could not be completed. The response includes error and may
            include code.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
        '502':
          description: >-
            Request could not be completed. The response includes error and may
            include code.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key authentication. Get your key at orgo.ai/workspaces

````