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

# Run an enabled app function

> Runs one function returned by GET /api/v2/apps/functions. Use the exact appId, appVersion, and name from the latest catalog response, and send an arguments object that matches its parameters JSON Schema. Vida re-resolves the published Agent configuration and rejects functions that are no longer assigned and enabled, or whose app is no longer installed. Do not send caller, account, Agent configuration, provider credentials, or app manifest data—Vida supplies the required context server-side. Each POST executes the function directly; after an ambiguous timeout on a function that changes external data, confirm the outcome before retrying it.




## OpenAPI

````yaml post /api/v2/apps/{appId}/{appVersion}/functions/{functionName}
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}/functions/{functionName}:
    post:
      tags:
        - Apps
      summary: Run an enabled app function
      description: >
        Runs one function returned by GET /api/v2/apps/functions. Use the exact
        appId, appVersion, and name from the latest catalog response, and send
        an arguments object that matches its parameters JSON Schema. Vida
        re-resolves the published Agent configuration and rejects functions that
        are no longer assigned and enabled, or whose app is no longer installed.
        Do not send caller, account, Agent configuration, provider credentials,
        or app manifest data—Vida supplies the required context server-side.
        Each POST executes the function directly; after an ambiguous timeout on
        a function that changes external data, confirm the outcome before
        retrying it.
      operationId: appsPostFunction
      parameters:
        - name: appId
          in: path
          required: true
          description: App identifier returned by GET /api/v2/apps/functions.
          schema:
            type: string
            minLength: 1
        - name: appVersion
          in: path
          required: true
          description: App version returned by GET /api/v2/apps/functions.
          schema:
            type: string
            minLength: 1
        - name: functionName
          in: path
          required: true
          description: Function name returned by GET /api/v2/apps/functions.
          schema:
            type: string
            minLength: 1
        - name: targetAccountId
          in: query
          required: true
          description: Computer Agent account whose enabled app functions should be used.
          schema:
            type: integer
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - arguments
              additionalProperties: false
              properties:
                arguments:
                  type: object
                  additionalProperties: true
                  description: >-
                    Arguments matching the selected function's parameters JSON
                    Schema.
            examples:
              checkAvailability:
                summary: Check Google Calendar availability
                value:
                  arguments:
                    startDateTime: '2026-08-27T15:00:00Z'
                    endDateTime: '2026-08-27T16:00:00Z'
                    timeZone: America/Denver
      responses:
        '200':
          description: Function result
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  function:
                    type: object
                    required:
                      - appId
                      - appVersion
                      - name
                    properties:
                      appId:
                        type: string
                      appVersion:
                        type: string
                      name:
                        type: string
                  result:
                    type: object
                    additionalProperties: true
                    description: >-
                      Vader function response, including its status, message,
                      data, and metadata when provided.
                required:
                  - function
                  - result
        '400':
          description: Arguments do not match the live function schema
        '401':
          description: The Vida API token is missing or invalid
        '403':
          description: The API token cannot access the selected account
        '404':
          description: >-
            The app is not installed or its function is not assigned and enabled
            on the published Agent configuration
        '502':
          description: Vader or the underlying integration could not execute the function
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: query
      name: token
      description: Vida API Token

````