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

# List Agents

> List the agents in your workspace

List every agent in your workspace, oldest first. Agents are configured in the Monumint app. This endpoint exists so an integration can look up the `agentId` it needs to [start a workflow run](/api-reference/workflow-runs/create-workflow-run).

## Authentication

Requires the `x-api-key` header with a valid workspace API key.

## Response

<ResponseField name="success" type="boolean">
  Whether the request succeeded.
</ResponseField>

<ResponseField name="agents" type="array">
  The workspace's agents, oldest first.

  <Expandable title="agent">
    <ResponseField name="id" type="string">
      The agent id. Pass this as `agentId` when starting a workflow run.
    </ResponseField>

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

    <ResponseField name="email" type="string | null">
      The agent's email address, if one is assigned.
    </ResponseField>

    <ResponseField name="phoneNumber" type="string | null">
      The agent's phone number in E.164, if one is assigned.
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      When the agent was created.
    </ResponseField>

    <ResponseField name="updatedAt" type="string">
      When the agent last changed.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```javascript Node.js theme={null}
  const options = {
    method: "GET",
    headers: { "x-api-key": "<your-api-key>" },
  };

  fetch("https://api-v2.getomni.ai/api/v1/agents", options)
    .then((response) => response.json())
    .then((response) => console.log(response))
    .catch((err) => console.error(err));
  ```

  ```python Python theme={null}
  import requests

  url = "https://api-v2.getomni.ai/api/v1/agents"
  headers = {"x-api-key": "<your-api-key>"}

  response = requests.request("GET", url, headers=headers)
  print(response.json())
  ```

  ```bash cURL theme={null}
  curl --request GET \
    --url https://api-v2.getomni.ai/api/v1/agents \
    --header 'x-api-key: <your-api-key>'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "agents": [
      {
        "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "name": "Sam",
        "email": "sam@pacificbank.getomni.ai",
        "phoneNumber": "+14155550142",
        "createdAt": "2026-03-02T15:20:11.000Z",
        "updatedAt": "2026-08-14T09:02:45.000Z"
      }
    ]
  }
  ```
</ResponseExample>