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

# Upload a Computer Agent workspace file

> Uploads one customer-created file to the selected Computer Agent workspace. Set overwrite to true to replace an existing file. Agent instructions, settings, and protected system files cannot be uploaded through this endpoint.




## OpenAPI

````yaml post /api/v2/computer/accounts/{targetAccountId}/workspace/upload
openapi: 3.0.0
info:
  version: 2.0.0
  title: Vida API
  description: Vida API Documentation
servers:
  - url: https://api.vida.dev
    description: Vida Production
    variables:
      baseUrl:
        default: api.vida.dev
        description: Production API Root
security: []
tags:
  - name: Agents
  - name: Inbound Email
    description: Control which senders may create inbound email work for an Agent.
  - name: Features
    description: Inspect capabilities available within an account hierarchy.
  - name: Conversation Logs
    description: Query conversation activity and calculate account-level metrics.
  - name: Computer Agents
    description: Set up, configure, inspect, and manage Vida Computer Agents.
  - name: Computer Agent Sessions
    description: View and reset Computer Agent sessions.
  - name: Accounts
  - name: Agent Templates
    description: Create, manage, and apply reusable Agent configurations.
paths:
  /api/v2/computer/accounts/{targetAccountId}/workspace/upload:
    post:
      tags:
        - Computer Agents
      summary: Upload a Computer Agent workspace file
      description: >
        Uploads one customer-created file to the selected Computer Agent
        workspace. Set overwrite to true to replace an existing file. Agent
        instructions, settings, and protected system files cannot be uploaded
        through this endpoint.
      operationId: workspacePostWorkspaceUpload
      parameters:
        - name: targetAccountId
          in: path
          required: true
          description: ''
          schema:
            type: string
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              required:
                - path
                - file
              properties:
                path:
                  type: string
                  description: Workspace-relative destination path.
                file:
                  type: string
                  format: binary
                  description: File to upload. Zero-byte files are supported.
                overwrite:
                  type: boolean
                  default: false
                  description: Replace an existing file at the destination path.
                mode:
                  type: string
                  pattern: ^[0-7]{3,4}$
                  example: '0600'
                  description: Optional Unix file permissions.
      responses:
        '200':
          description: Successful response
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: query
      name: token
      description: Vida API Token

````