Skip to main content

Documentation Index

Fetch the complete documentation index at: https://koreai.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Human Task APIs allow applications and workflows to programmatically manage approval and Data Entry tasks. Use Human Task APIs to:
  • View tasks
  • Claim tasks
  • Resolve tasks
  • Assign tasks

​
View pending tasks

Endpoint: GET /api/projects/:projectId/human-tasks?status=pending Tasks can include:
FieldDescription
Typeapproval, data_entry, review, decision, escalation
Statuspending, assigned, in_progress, completed, expired, cancelled
Prioritylow, medium, high, critical
TitleDescription of what needs human attention
ContextRelevant data from the conversation
FieldsForm fields for data collection
Due atSLA deadline (if configured)

​
Claim a task

Endpoint: POST /api/projects/:projectId/human-tasks/:taskId/claim Content-Type: application/json 
{"userId": "your-user-id"}

​
Resolve a task

Endpoint: POST /api/projects/:projectId/human-tasks/:taskId/resolve Content-Type: application/json 
{
 "respondedBy": "user-id",
 "decision": "approved",
 "fields": {
   "override_reason": "Manager verified customer identity",
   "approved_amount": 15000
 },
 "notes": "Customer provided additional documentation"
}
After resolution, workflow or agent execution resumes with the human decision available in the execution context.

​
Assign a task

Endpoint: POST /api/projects/:projectId/human-tasks/:taskId/assign Content-Type: application/json 
{"assignedTo": "manager-user-id"}
Or assign to a team: 
{
 "assignedToTeam": "finance-approvers"
}