Task List
The task list shows all pending HIL tasks assigned to you or your role. Each row displays the task title, type, workflow name, requester, and due date — click any row to open the full task detail.
Task List Layout
Tasks are displayed as a vertical list of cards, sorted by due date (earliest first) by default. The sort order can be changed. Here are representative tasks as they appear in the inbox:
Task Row Fields
| Field | Description | Source |
|---|---|---|
| Type Indicator | Colored dot: blue=approval, green=form, yellow=review | task.type |
| Task Title | Human-readable name configured in Flow Studio HIL node | task.title |
| Task Type Label | Text label: Approval | Form | Review | task.type |
| Workflow Name | The Flow Studio workflow this task belongs to | task.workflowName |
| Requester | Who triggered the workflow — name and avatar | task.requester.name |
| Due Date | Relative display (overdue, due today, due tomorrow, due in N days) | task.dueAt |
| Claimed By | If claimed: shows the claimer's avatar — grayed out if claimed by someone else | task.claimedBy |
| Urgency Badge | Optional HIGH / URGENT badge set by the workflow designer | task.urgency |
API — Task List Response
GET /api/workdesk/inbox?status=pending&page=1&pageSize=20
Authorization: Bearer {token}
// Response
{
"items": [
{
"taskId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"executionId": "7bc12d45-1234-5678-abcd-ef0123456789",
"type": "approval", // approval | form | review
"title": "Expense Report Approval — Q1 Marketing",
"description": "Review the Q1 expense report and approve or reject.",
"workflowName": "Expense Approval Flow",
"workflowId": "wf-expense-001",
"requester": {
"actorId": "usr-123",
"name": "Sarah Chen",
"email": "sarah@acme.com",
"avatarUrl": "/avatars/sarah.png"
},
"dueAt": "2026-05-27T17:00:00Z",
"urgency": "normal", // low | normal | high | urgent
"status": "pending",
"claimedBy": null,
"formId": null, // non-null for type: form
"createdAt": "2026-05-25T10:00:00Z",
"tenantId": "tenant-acme"
}
],
"totalCount": 7,
"page": 1,
"pageSize": 20
}Sorting Options
| Sort By | Description | Default? |
|---|---|---|
| Due Date (Earliest First) | Overdue tasks at the top — most urgent first | Yes |
| Due Date (Latest First) | Tasks with furthest deadlines first | No |
| Created Date (Newest) | Most recently assigned tasks first | No |
| Created Date (Oldest) | Oldest tasks first — FIFO queue ordering | No |
| Urgency | URGENT → HIGH → NORMAL → LOW | No |
| Workflow Name | Alphabetical by workflow name | No |
Pagination
The task list is paginated. The default page size is 20. A "Load More" button at the bottom of the list fetches the next page and appends items — no full page reload. The total count is shown in the header (7 pending tasks).
In multi-actor role-based scenarios, tasks assigned to your role (not just you personally) appear in your inbox but may be claimed by a colleague. Claimed tasks show a "Claimed by [Name]" indicator and the action buttons are disabled until the claim is released.