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

# Get agent app

> Returns one Vader app manifest and its installation and activation state for the selected Computer Agent account. Inspect dependencies and their required values before installing or updating the app. Use the exact appId and appVersion returned by the app catalog.




## OpenAPI

````yaml get /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}:
    get:
      tags:
        - Apps
      summary: Get agent app
      description: >
        Returns one Vader app manifest and its installation and activation state
        for the selected Computer Agent account. Inspect dependencies and their
        required values before installing or updating the app. Use the exact
        appId and appVersion returned by the app catalog.
      operationId: appsGetRecord
      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
      responses:
        '200':
          description: App manifest and account-specific state
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  app:
                    $ref: '#/components/schemas/AgentAppManifest'
                required:
                  - app
        '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 app was not found
        '502':
          description: Vader could not provide the app manifest
      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

````