> ## Documentation Index
> Fetch the complete documentation index at: https://allhandsai-chore-regenerate-agent-sdk-openapi.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List Agent Profiles

> List all stored agent profiles and the active pointer.

On the first call against an empty store with no active pointer, lazily
seeds one default profile from the current ``agent_settings`` and activates
it (the one-time migration that replaces a dedicated seed step).



## OpenAPI

````yaml /openapi/agent-sdk.json get /api/agent-profiles
openapi: 3.1.0
info:
  description: OpenHands Agent Server - REST/WebSocket interface for OpenHands AI Agent
  title: OpenHands Agent Server
  version: 1.52.0
servers: []
security: []
paths:
  /api/agent-profiles:
    get:
      tags:
        - Agent Profiles
      summary: List Agent Profiles
      description: >-
        List all stored agent profiles and the active pointer.


        On the first call against an empty store with no active pointer, lazily

        seeds one default profile from the current ``agent_settings`` and
        activates

        it (the one-time migration that replaces a dedicated seed step).
      operationId: list_agent_profiles_api_agent_profiles_get
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentProfileListResponse'
          description: Successful Response
      security:
        - APIKeyHeader: []
components:
  schemas:
    AgentProfileListResponse:
      properties:
        active_agent_profile_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Active Agent Profile Id
        profiles:
          items:
            $ref: '#/components/schemas/AgentProfileInfo'
          title: Profiles
          type: array
      required:
        - profiles
      title: AgentProfileListResponse
      type: object
    AgentProfileInfo:
      description: Summary projection of a stored profile (no secret instantiation).
      properties:
        agent_kind:
          default: openhands
          title: Agent Kind
          type: string
        id:
          anyOf:
            - type: string
            - type: 'null'
          title: Id
        llm_profile_ref:
          anyOf:
            - type: string
            - type: 'null'
          title: Llm Profile Ref
        mcp_server_refs:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Mcp Server Refs
        name:
          title: Name
          type: string
        revision:
          anyOf:
            - type: integer
            - type: 'null'
          title: Revision
      required:
        - name
      title: AgentProfileInfo
      type: object
  securitySchemes:
    APIKeyHeader:
      in: header
      name: X-Session-API-Key
      type: apiKey

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.