> ## 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.

# Upgrade a Computer Agent

> Upgrades the shared Computer to Vida's current published version, refreshes managed workspace templates without replacing customer Canvas or project files, and affects every Agent assigned to that Computer. Check status until the operation is terminal, then verify Computer health.




## OpenAPI

````yaml post /api/v2/computer/accounts/{targetAccountId}/upgrade
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}/upgrade:
    post:
      tags:
        - Computer Agents
      summary: Upgrade a Computer Agent
      description: >
        Upgrades the shared Computer to Vida's current published version,
        refreshes managed workspace templates without replacing customer Canvas
        or project files, and affects every Agent assigned to that Computer.
        Check status until the operation is terminal, then verify Computer
        health.
      operationId: lifecyclePostUpgrade
      parameters:
        - name: targetAccountId
          in: path
          required: true
          description: ''
          schema:
            type: string
      responses:
        '202':
          description: Upgrade was accepted
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: query
      name: token
      description: Vida API Token

````