Skip to main content
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"
}