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

# List AI employees

> The three AI employees, their goals, their tools and how many actions wait for each.

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 `connected: true` when your organisation has attached a saved connection to it; every other tool except your knowledge reports `connected: false`.

> [!WARNING]
>
> 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](https://docs.mithunai.com/team/connect-your-tools.md)). See
> [AI employees](https://docs.mithunai.com/team/overview.md).

Requires a role that can read agents: owner, admin, editor or member.

## Response

**data** `object[]` *required*

One entry per employee.

**properties**

**role** `string` *required*

`support`, `itsm`, `devops`, `marketer`, `sales` or `finance`.

**name** `string` *required*

The employee's name.

**goal** `string` *required*

What it is for.

**tools** `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.

**actions** `object[]` *required*

`action_type`, `title`, `side_effect`, `always_requires_approval` and `editable_fields`.

**pending\_approvals** `integer` *required*

How many of its actions wait for a person.


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