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

# Update installed agent app

> Updates an installed Vader app for the selected Computer Agent account. To change configuration, fetch the current app, edit its dependency values, and send that complete manifest as app. Set reload to true to replace its stored manifest with the current catalog manifest. Read the returned manifest and verify active before relying on its functions.




## OpenAPI

````yaml put /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}:
    put:
      tags:
        - Apps
      summary: Update installed agent app
      description: >
        Updates an installed Vader app for the selected Computer Agent account.
        To change configuration, fetch the current app, edit its dependency
        values, and send that complete manifest as app. Set reload to true to
        replace its stored manifest with the current catalog manifest. Read the
        returned manifest and verify active before relying on its functions.
      operationId: appsPutRecord
      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: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              properties:
                app:
                  type: object
                  nullable: true
                  additionalProperties: true
                  description: >-
                    Complete current app manifest with updated dependency
                    values.
                reload:
                  type: boolean
                  nullable: true
                  default: false
                  description: >-
                    Reload the current catalog manifest instead of applying app
                    values.
      responses:
        '200':
          description: Updated app manifest and activation state
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  app:
                    $ref: '#/components/schemas/AgentAppManifest'
                required:
                  - app
        '400':
          description: The app or reload value 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 installed app was not found
        '502':
          description: Vader could not update 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

````