> ## 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 agent app

> Installs the selected Vader app for the Computer Agent account. Read the app manifest first and when its dependencies require configuration or authentication values, send that complete app manifest with the required values filled in. Omit app when the catalog manifest needs no changes. After installation, verify the returned active state before enabling its functions in an Agent configuration. Do not send an empty object as app because Vader treats app as a replacement manifest.




## OpenAPI

````yaml post /api/v2/apps/{appId}/{appVersion}
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: Apps
    description: Install Vida apps and use their enabled integration functions.
  - name: Integrations
    description: Configure Vader integrations.
  - 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/apps/{appId}/{appVersion}:
    post:
      tags:
        - Apps
      summary: Install agent app
      description: >
        Installs the selected Vader app for the Computer Agent account. Read the
        app manifest first and when its dependencies require configuration or
        authentication values, send that complete app manifest with the required
        values filled in. Omit app when the catalog manifest needs no changes.
        After installation, verify the returned active state before enabling its
        functions in an Agent configuration. Do not send an empty object as app
        because Vader treats app as a replacement manifest.
      operationId: appsPostRecord
      parameters:
        - name: appId
          in: path
          required: true
          description: App identifier returned by GET /api/v2/apps.
          schema:
            type: string
            minLength: 1
        - name: appVersion
          in: path
          required: true
          description: Exact app version returned by GET /api/v2/apps.
          schema:
            type: string
            minLength: 1
        - name: targetAccountId
          in: query
          required: false
          description: >-
            Computer Agent account whose app state should be used. Defaults to
            the API token account.
          schema:
            type: integer
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              properties:
                app:
                  type: object
                  nullable: true
                  additionalProperties: true
                  description: >-
                    Complete app manifest returned by GET, with required
                    dependency values filled in.
      responses:
        '201':
          description: App installed successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  app:
                    $ref: '#/components/schemas/AgentAppManifest'
                required:
                  - app
        '400':
          description: The app payload is invalid
        '401':
          description: The Vida API token is missing or invalid
        '403':
          description: The API token cannot access the selected account
        '404':
          description: The selected account or catalog app was not found
        '409':
          description: The app is already installed for the selected account
        '502':
          description: Vader could not install the app
      security:
        - apiKeyAuth: []
components:
  schemas:
    AgentAppManifest:
      type: object
      description: Agent app metadata and account-specific setup state.
      properties:
        appId:
          type: string
          description: Stable app identifier.
        version:
          type: string
          description: App version.
        title:
          type: string
          description: Display name.
        description:
          type: string
          description: What the app enables.
        installed:
          type: boolean
          readOnly: true
          description: Whether this app is installed for the selected account.
        active:
          type: boolean
          readOnly: true
          description: Whether required setup is complete and the app can be used.
        dependencies:
          type: object
          additionalProperties: true
          description: >-
            Authentication and configuration requirements. Required properties
            include their current account-specific values when available.
      additionalProperties: true
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: query
      name: token
      description: Vida API Token

````