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

# List Agents

> Returns the Agents on your account.

<ParamField header="X-API-KEY" type="string" required>
  Your OpenHome API key.
</ParamField>

<ParamField query="with_image" type="boolean" default="false">
  Include each Agent's image URL in the response.
</ParamField>

<ResponseField name="personalities" type="array">
  Array of Agent objects.

  <Expandable title="Agent">
    <ResponseField name="id" type="integer">
      Agent ID.
    </ResponseField>

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

    <ResponseField name="image" type="string">
      URL of the Agent's image (only present when `with_image=true`).
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={"system"}
  curl "https://app.openhome.com/api/personalities/get-all-personalities/?with_image=true" \
    -H "X-API-KEY: YOUR_KEY"
  ```

  ```python Python theme={"system"}
  import requests

  requests.get(
      "https://app.openhome.com/api/personalities/get-all-personalities/",
      headers={"X-API-KEY": "YOUR_KEY"},
      params={"with_image": True},
  )
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"system"}
  {
    "personalities": [
      {
        "id": 4727,
        "name": "Default Agent",
        "image": "https://app.openhome.com/media/user_personalities/32/image/test.png"
      },
      {
        "id": 5823,
        "name": "Custom Assistant",
        "image": "https://app.openhome.com/media/user_personalities/32/image/test.png"
      }
    ]
  }
  ```
</ResponseExample>