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

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:

| Field    | Description                                                    |
| -------- | -------------------------------------------------------------- |
| Type     | approval, data\_entry, review, decision, escalation            |
| Status   | pending, assigned, in\_progress, completed, expired, cancelled |
| Priority | low, medium, high, critical                                    |
| Title    | Description of what needs human attention                      |
| Context  | Relevant data from the conversation                            |
| Fields   | Form fields for data collection                                |
| Due at   | SLA deadline (if configured)                                   |

## Claim a task

**Endpoint**: `POST /api/projects/:projectId/human-tasks/:taskId/claim`
**Content-Type**: `application/json`

```json theme={null}
{"userId": "your-user-id"}
```

## Resolve a task

**Endpoint**: `POST /api/projects/:projectId/human-tasks/:taskId/resolve`

**Content-Type**: `application/json`

```json theme={null}
{
 "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`

```json theme={null}
{"assignedTo": "manager-user-id"}
```

Or assign to a team:

```json theme={null}
{
 "assignedToTeam": "finance-approvers"
}
```