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

# List Agents

> List the agents in your organization, most recently updated first.

### Overview

Returns every live agent in your organization, ordered by `updated_at` descending. Each entry is the agent record without its environments; call [Get Agent](/api-v2/get/agents-id) for environment pointers.

### Headers

<ParamField header="authorization" type="string" required>
  Your API key for authentication.
</ParamField>

### Query Parameters

<ParamField query="limit" type="integer" default="100">
  Maximum number of agents to return. Minimum `1`, maximum `500`. Values outside that range are clamped.
</ParamField>

### Response

<ResponseField name="data" type="array">
  Array of agent objects.

  <Expandable title="agent object">
    <ResponseField name="id" type="string">
      Unique identifier for the agent.
    </ResponseField>

    <ResponseField name="org_id" type="string">
      The organization that owns the agent.
    </ResponseField>

    <ResponseField name="name" type="string">
      The agent's display name.
    </ResponseField>

    <ResponseField name="created_by" type="string | null">
      ID of the user who created the agent, or `null` when created with an org-level key.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp of creation.
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      ISO 8601 timestamp of the last update.
    </ResponseField>

    <ResponseField name="deleted_at" type="null">
      Always `null` on a live agent.
    </ResponseField>

    <ResponseField name="color" type="string">
      The agent's chosen identity color, read from its newest saved version. Omitted when no color has been picked.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="errors" type="null | array">
  `null` on success, or a list of error objects if the request failed.
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "data": [
      {
        "id": "c7dc8803-c265-46a7-86bc-92edf72af434",
        "org_id": "45794f66-94ca-44a2-9248-202c5ff22717",
        "name": "Appointment reminders",
        "created_by": "bd8ae00b-c51d-4364-b1b3-245ad579c44a",
        "created_at": "2026-09-09T14:12:03.101Z",
        "updated_at": "2026-09-10T18:40:27.882Z",
        "deleted_at": null,
        "color": "teal"
      },
      {
        "id": "01a60218-bdd1-41eb-8612-2ef3f60dd80d",
        "org_id": "45794f66-94ca-44a2-9248-202c5ff22717",
        "name": "Front desk",
        "created_by": "6fb2ce4c-507f-45e5-9dcb-45d3139b04fd",
        "created_at": "2026-09-08T09:30:44.005Z",
        "updated_at": "2026-09-08T09:30:44.005Z",
        "deleted_at": null
      }
    ],
    "errors": null
  }
  ```
</ResponseExample>

***

Docs for agents: [llms.txt](/llms.txt)