> ## Documentation Index
> Fetch the complete documentation index at: https://docs.monumint.com/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](https://docs.monumint.com/api-reference/workflow-runs/create-workflow-run.md).

## Authentication

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

## Response

**success** `boolean`

Whether the request succeeded.

**agents** `array`

The workspace's agents, oldest first.

**agent**

**id** `string`

The agent id. Pass this as `agentId` when starting a workflow run.

**name** `string | null`

The agent's display name.

**email** `string | null`

The agent's email address, if one is assigned.

**phoneNumber** `string | null`

The agent's phone number in E.164, if one is assigned.

**createdAt** `string`

When the agent was created.

**updatedAt** `string`

When the agent last changed.

```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>'
```

```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"
    }
  ]
}
```


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