> ## Documentation Index
> Fetch the complete documentation index at: https://docs.osvi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Active Agents

> Returns the voice agents on your account that are currently **active** (and not archived) — i.e. the agents able to take calls right now. Useful for validating an `agent_uuid` before triggering `POST /v1/call`, or for populating an agent picker in your own system.

Agents are ordered by most recently updated first.



## OpenAPI

````yaml GET /v1/active_agents
openapi: 3.1.0
info:
  title: OSVI AI API
  description: REST API for the OSVI AI voice and chat platform
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.osvi.ai
security:
  - ApiToken: []
paths:
  /v1/active_agents:
    get:
      summary: List active agents
      description: >-
        Returns the voice agents on your account that are currently **active**
        (and not archived) — i.e. the agents able to take calls right now.
        Useful for validating an `agent_uuid` before triggering `POST /v1/call`,
        or for populating an agent picker in your own system.


        Agents are ordered by most recently updated first.
      responses:
        '200':
          description: >-
            Array of active agents. Returns `[]` when no agents are active.
            Note: unlike other v1 endpoints, the response is a bare array
            without a `success`/`data` wrapper.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ActiveAgent'
              example:
                - agent_id: agent_IsZ3Q6Sf_60Eh26XQMGbz-R_og
                  name: Appointment Reminder
                  status: active
                - agent_id: agent_x9KpL2Mn_41Tg83YWQNca-B_pe
                  name: Support Line
                  status: active
        '401':
          description: Invalid or missing API token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorUnauthorized'
components:
  schemas:
    ActiveAgent:
      type: object
      properties:
        agent_id:
          type: string
          description: >-
            The agent's unique identifier — the value to pass as `agent_uuid`
            elsewhere in the API.
          example: agent_IsZ3Q6Sf_60Eh26XQMGbz-R_og
        name:
          type: string
          description: The agent's display name from the dashboard.
          example: Appointment Reminder
        status:
          type: string
          description: >-
            Always `active` — inactive and archived agents are excluded from
            this endpoint.
          enum:
            - active
          example: active
    ErrorUnauthorized:
      type: object
      properties:
        success:
          type: boolean
          example: false
        error:
          type: string
          example: Invalid API token
  securitySchemes:
    ApiToken:
      type: apiKey
      in: header
      name: API-Token
      description: >-
        16-character API token associated with your OSVI account. Find it in
        your dashboard under Settings → API.

````