Test a connected tool
Make one harmless read through a tool’s saved connection and hear what it found, in plain English.
POST
/
employees
/
{role}
/
tools
/
{tool}
/
{kind}
/
test
Test a connected tool
curl --request POST \
--url https://app.mithunai.com/mithunai/api/v1/employees/{role}/tools/{tool}/{kind}/test \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.mithunai.com/mithunai/api/v1/employees/{role}/tools/{tool}/{kind}/test"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.mithunai.com/mithunai/api/v1/employees/{role}/tools/{tool}/{kind}/test', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"outcome": "<string>",
"message": "<string>"
}One read at the vendor that changes nothing. The answer says whether the token works here.
Requires owner or admin, and a person: an API key is refused. Audited.
AI employees are in beta. Every route answers
404 unless your deployment has switched the
beta on. See AI employees.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.
string
required
support, itsm, devops, marketer, sales or finance.string
required
The tool, as in Connect a tool.
string
required
The kind of the attached connection, as in Disconnect a
tool.
Off by default.
principal_id is only accepted while the deployment has switched on
MITHUNAI_AI_EMPLOYEES_PERSONAL_MAILBOXES.string
One person’s own attachment (UUID); absent means the organization’s. See Connect a
tool.
Response
string
required
ok, bad_token, wrong_address, missing_permission or vendor_unavailable.string
required
What it found and what to do, in plain English.
Last modified on November 11, 2026
Test a connected tool
curl --request POST \
--url https://app.mithunai.com/mithunai/api/v1/employees/{role}/tools/{tool}/{kind}/test \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.mithunai.com/mithunai/api/v1/employees/{role}/tools/{tool}/{kind}/test"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.mithunai.com/mithunai/api/v1/employees/{role}/tools/{tool}/{kind}/test', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"outcome": "<string>",
"message": "<string>"
}