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

# Get an AI-employee task

> One piece of work, its plan and every action it proposed.

Returns one task. Another organisation's task returns `404`.

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

**task\_id** `string` *required*

The task's `id`.

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