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.
POST
/
employees
/
{role}
/
tasks
Hand an AI employee a piece of work
curl --request POST \
--url https://app.mithunai.com/mithunai/api/v1/employees/{role}/tasks \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"title": "<string>"
}
'import requests
url = "https://app.mithunai.com/mithunai/api/v1/employees/{role}/tasks"
payload = { "title": "<string>" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({title: '<string>'})
};
fetch('https://app.mithunai.com/mithunai/api/v1/employees/{role}/tasks', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "<string>",
"role": "<string>",
"status": "<string>",
"created_at": "<string>",
"submitted_by": "<string>",
"item": {},
"plan": [
{}
],
"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; one your policy lets run is carried out at once, on your authority.
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
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). See
AI employees.requester, and only for an application in your catalogue.
Requires owner, admin or editor. Returns 201.
string
required
Which employee:
support, itsm (IT service desk), devops, marketer, sales or finance.string
required
What the work is about. Cut at 200 characters.
string
The message, ticket text or alert detail. Cut at 8,000 characters.
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.
string
Where it came from, such as
email, slack or alert.string
Its ID in that channel: a ticket key, a thread or an incident. For Sales, the lead’s CRM record
ID.
string
DevOps only, and required for it: the service the alert is about.
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
string
required
The task’s ID.
string
required
support, itsm, devops, marketer, sales or finance.string
required
waiting_for_approval or done.string
required
ISO 8601.
string
required
Who handed the work over.
object
required
The work as it arrived:
title, body, requester, channel, reference, service,
assistant_id.object[]
required
The steps, in order:
description, kind (read or action) and, for an action, its
action_id.object[]
required
Every action it proposed, in the shape Approve an
action returns.
Last modified on November 7, 2026
Hand an AI employee a piece of work
curl --request POST \
--url https://app.mithunai.com/mithunai/api/v1/employees/{role}/tasks \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"title": "<string>"
}
'import requests
url = "https://app.mithunai.com/mithunai/api/v1/employees/{role}/tasks"
payload = { "title": "<string>" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({title: '<string>'})
};
fetch('https://app.mithunai.com/mithunai/api/v1/employees/{role}/tasks', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "<string>",
"role": "<string>",
"status": "<string>",
"created_at": "<string>",
"submitted_by": "<string>",
"item": {},
"plan": [
{}
],
"actions": [
{}
]
}