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

# Test a connected tool

> Make one harmless read through a tool's saved connection and hear what it found, in plain English.

One read at the vendor that changes nothing. The answer says whether the token works here.

> [!WARNING]
>
> AI employees are in **beta**. Every route answers `404` unless your deployment has switched the
> beta on. See [AI employees](https://docs.mithunai.com/team/overview.md).

Requires owner or admin, and a person: an API key is refused. Audited. `200` whatever it finds, because the answer is the result. Nothing of that kind attached is `404`. No text of the vendor's comes back.

**role** `string` *required*

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

**tool** `string` *required*

The tool, as in [Connect a tool](https://docs.mithunai.com/api-reference/employees/attach-tool.md).

**kind** `string` *required*

The kind of the attached connection, as in [Disconnect a
tool](https://docs.mithunai.com/api-reference/employees/detach-tool.md).

> [!NOTE]
>
> Off by default. `principal_id` is only accepted while the deployment has switched on
> `MITHUNAI_AI_EMPLOYEES_PERSONAL_MAILBOXES`.

**principal\_id** `string`

One person's own attachment (UUID); absent means the organization's. See [Connect a
tool](https://docs.mithunai.com/api-reference/employees/attach-tool.md).

## Response

**outcome** `string` *required*

`ok`, `bad_token`, `wrong_address`, `missing_permission` or `vendor_unavailable`.

**message** `string` *required*

What it found and what to do, in plain English.


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