> ## 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.

# Hand an AI employee a piece of work

> Give an AI employee a ticket, IT request, alert, topic, lead or finance request. It plans, reads, answers from your knowledge and proposes actions.

The employee plans the work, reads through its tools and your knowledge straight away, and proposes actions. Each one goes through your approval policy: an action that needs a person waits in the [approval queue](https://docs.mithunai.com/api-reference/employees/list-approvals.md); one your policy lets run is carried out at once, on your authority.

> [!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).

The plan is fixed for each employee. Nothing in the text you send chooses what it does: an access request or a password reset is only ever for `requester`, and only for an application in your catalogue.

Requires owner, admin or editor. Returns `201`.

**role** `string` *required*

Which employee: `support`, `itsm` (IT service desk), `devops`, `marketer`, `sales` or `finance`.

**title** `string` *required*

What the work is about. Cut at 200 characters.

**body** `string`

The message, ticket text or alert detail. Cut at 8,000 characters.

**requester** `string`

Who asked, as your channel reported it. An identity change is only ever for this person. For
Sales, the lead's email address: the follow-up is only ever sent to it, and its domain is the
company website read when your CRM holds none. For Finance, who a reply goes to.

**channel** `string`

Where it came from, such as `email`, `slack` or `alert`.

**reference** `string`

Its ID in that channel: a ticket key, a thread or an incident. For Sales, the lead's CRM record
ID.

**service** `string`

DevOps only, and required for it: the service the alert is about.

**assistant\_id** `string`

The assistant whose knowledge answers questions in this work. The answer is a normal conversation
on that assistant and counts against your monthly answers. Another organisation's assistant
returns `404`.

## Response

**id** `string` *required*

The task's ID.

**role** `string` *required*

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

**status** `string` *required*

`waiting_for_approval` or `done`.

**created\_at** `string` *required*

ISO 8601.

**submitted\_by** `string` *required*

Who handed the work over.

**item** `object` *required*

The work as it arrived: `title`, `body`, `requester`, `channel`, `reference`, `service`,
`assistant_id`.

**plan** `object[]` *required*

The steps, in order: `description`, `kind` (`read` or `action`) and, for an action, its
`action_id`.

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

Every action it proposed, in the shape [Approve an
action](https://docs.mithunai.com/api-reference/employees/approve-action.md) returns.


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