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));
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())
curl --request GET \
--url https://api-v2.getomni.ai/api/v1/agents \
--header 'x-api-key: <your-api-key>'
{
"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"
}
]
}
Agents
List Agents
List the agents in your workspace
GET
/
api
/
v1
/
agents
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));
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())
curl --request GET \
--url https://api-v2.getomni.ai/api/v1/agents \
--header 'x-api-key: <your-api-key>'
{
"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"
}
]
}
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.
Authentication
Requires thex-api-key header with a valid workspace API key.
Response
boolean
Whether the request succeeded.
array
The workspace’s agents, oldest first.
Show agent
Show agent
string
The agent id. Pass this as
agentId when starting a workflow run.string | null
The agent’s display name.
string | null
The agent’s email address, if one is assigned.
string | null
The agent’s phone number in E.164, if one is assigned.
string
When the agent was created.
string
When the agent last changed.
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));
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())
curl --request GET \
--url https://api-v2.getomni.ai/api/v1/agents \
--header 'x-api-key: <your-api-key>'
{
"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"
}
]
}