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

# Agents auflisten

> Liste Pharen Hub KI-Agenten auf, die der API-Key sehen darf, inklusive Agent-UUIDs für anschließende Chat-, Run- und Konfigurationsanfragen.

Gibt Agents zuruck, die die erstellende Person des Keys sehen darf. Nutze diesen Endpunkt, um Agent-UUIDs fur Chat-Anfragen zu finden.

<Note>
  Erforderlicher API-Key-Scope: `agents:read`.
</Note>

## Query-Parameter

<ParamField query="team_id" type="string">
  Team-UUID fur teambegrenzte Keys.
</ParamField>

## Antwort

<ResponseField name="id" type="string">
  Agent-UUID.
</ResponseField>

<ResponseField name="name" type="string">
  Agent-Name.
</ResponseField>

<ResponseField name="description" type="string">
  Agent-Beschreibung.
</ResponseField>

<ResponseField name="is_active" type="boolean">
  Gibt an, ob der Agent aktiv ist.
</ResponseField>


## OpenAPI

````yaml openapi.json GET /api/agents/
openapi: 3.1.0
info:
  title: Pharen Hub API
  version: 1.0.0
  description: >-
    Scoped REST API for Pharen Hub workspaces, calendars, lists, docs,
    workflows, and agents.
servers:
  - url: '{baseUrl}'
    description: Pharen Hub API base URL
    variables:
      baseUrl:
        default: https://pharen.app
        description: >-
          The Pharen Hub API origin. Keep the default for production, or enter
          another environment such as http://localhost:8000.
security:
  - bearerAuth: []
tags:
  - name: Calendar
    description: Calendar source and event operations.
  - name: Lists
    description: Saved list data and metadata operations.
  - name: Docs
    description: Document and collection operations.
  - name: Workflows
    description: Workflow definition and execution operations.
  - name: Agents
    description: Agent catalog and chat operations.
paths:
  /api/agents/:
    get:
      tags:
        - Agents
      summary: List agents
      description: Fetch agents available to the API key. Requires the `agents:read` scope.
      operationId: listAgents
      parameters:
        - name: team_id
          in: query
          description: Team UUID for team-scoped keys.
          schema:
            type: string
            format: uuid
        - name: page
          in: query
          description: Page number for paginated results.
          schema:
            type: integer
            minimum: 1
            default: 1
        - name: per_page
          in: query
          description: Number of results per page.
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
      responses:
        '200':
          description: Agents returned.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedAgents'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
components:
  schemas:
    PaginatedAgents:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/Agent'
        total:
          type: integer
        page:
          type: integer
        per_page:
          type: integer
    Agent:
      type: object
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
        description:
          type: string
        team_id:
          type: string
          format: uuid
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              example: forbidden
            message:
              type: string
              example: This API key does not have the required scope.
            details:
              type: object
              additionalProperties: true
  responses:
    Unauthorized:
      description: The request did not include a valid API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Forbidden:
      description: >-
        The API key is valid but does not have the required scope or workspace
        access.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Paste your Pharen API key without the Bearer prefix.
      x-default: phk_your_api_key

````