List AI employees
The three AI employees, their goals, their tools and how many actions wait for each.
GET
/
employees
List AI employees
curl --request GET \
--url https://app.mithunai.com/mithunai/api/v1/employees \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.mithunai.com/mithunai/api/v1/employees"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.mithunai.com/mithunai/api/v1/employees', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": [
{
"role": "<string>",
"name": "<string>",
"goal": "<string>",
"tools": [
{}
],
"actions": [
{}
],
"pending_approvals": 123
}
]
}Returns Support, IT service desk and DevOps, each with its goal, the tools it works in, the kinds of action it may propose and how many are waiting for approval. A tool reports
Requires a role that can read agents: owner, admin, editor or member.
connected: true when your organisation has attached a saved connection to it; every other tool except your knowledge reports connected: false.
AI employees are in beta. Every route answers
404 unless your deployment has switched the
beta on. A tool with no saved connection reaches nothing: an approved action on it is recorded as
not_sent, with the draft to use by hand (Connect your tools). See
AI employees.Response
object[]
required
One entry per employee.
Show properties
Show properties
string
required
support, itsm, devops, marketer, sales or finance.string
required
The employee’s name.
string
required
What it is for.
object[]
required
kind, name, vendors, connected, connectable_kinds — the kinds of saved connection
it takes, empty when it cannot be connected yet — and connections, what is attached:
kind, credential_id, credential_name, host, options, attached_by and
attached_at. Never a secret.object[]
required
action_type, title, side_effect, always_requires_approval and editable_fields.integer
required
How many of its actions wait for a person.
Last modified on November 3, 2026
List AI employees
curl --request GET \
--url https://app.mithunai.com/mithunai/api/v1/employees \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.mithunai.com/mithunai/api/v1/employees"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.mithunai.com/mithunai/api/v1/employees', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": [
{
"role": "<string>",
"name": "<string>",
"goal": "<string>",
"tools": [
{}
],
"actions": [
{}
],
"pending_approvals": 123
}
]
}