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

# Install a Computer Agent skill

> Installs one skill returned by the Computer Agent skill catalog. Read the skill detail first and select an installation option when more than one is available. Verify the skill immediately after installation to obtain its current setup requirements.




## OpenAPI

````yaml post /api/v2/computer/accounts/{targetAccountId}/skills/install
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}/skills/install:
    post:
      tags:
        - Computer Agents
      summary: Install a Computer Agent skill
      description: >
        Installs one skill returned by the Computer Agent skill catalog. Read
        the skill detail first and select an installation option when more than
        one is available. Verify the skill immediately after installation to
        obtain its current setup requirements.
      operationId: skillsPostInstall
      parameters:
        - name: targetAccountId
          in: path
          required: true
          description: ''
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - skillSlug
              properties:
                skillSlug:
                  type: string
                  description: Skill identifier returned by the skill catalog.
                installId:
                  type: string
                  description: Installation option identifier returned by the skill detail.
                timeoutMs:
                  type: integer
                  minimum: 1000
                  maximum: 300000
                  default: 300000
                  description: Maximum time allowed for installation.
      responses:
        '200':
          description: Skill installation finished
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  curated:
                    type: boolean
                  catalog:
                    type: object
                    additionalProperties: true
                    description: Refreshed skill detail and readiness state.
                  install:
                    type: object
                    additionalProperties: true
                required:
                  - curated
                  - catalog
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: query
      name: token
      description: Vida API Token

````