Skip to main content
GET
/
api
/
work-tasks
List work tasks
curl --request GET \
  --url https://dev.exante.app/api/work-tasks \
  --header 'Authorization: Bearer <token>'
{
  "status": "success",
  "status_code": 200,
  "message": "Work tasks retrieved",
  "data": {
    "items": [
      {
        "uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "title": "<string>",
        "type": "task",
        "status": "todo",
        "priority": "urgent",
        "due_date": "2023-12-25",
        "created_at": "2023-11-07T05:31:56Z",
        "assign_to": {
          "type": "user",
          "user_uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "agent_uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "full_name": "<string>",
          "name": "<string>",
          "avatar_url": "<string>"
        },
        "origin": {
          "type": "user",
          "user_uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "agent_uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "user_name": "<string>",
          "agent_name": "<string>",
          "avatar_url": "<string>",
          "trigger_type": "<string>"
        }
      }
    ],
    "_meta": {
      "page": 123,
      "per_page": 123,
      "total_pages": 123,
      "total_items": 123
    }
  }
}
Returns a paginated, filterable list of work tasks for the user’s organization. Each item uses a lean payload suited for table views.

​
When to use

Use this endpoint to populate task dashboards and lists. For full task detail (description, context entities, change log, HIL data), use Get work task on individual items. For building filter controls (dropdowns, multi-selects), use Filter options to get the available values.

​
Organization scoping

  • If organization_uid is omitted, the API uses your default organization.
  • If organization_uid is invalid, the API returns 400.
  • If you are not a member of the requested organization, the API returns 403.

​
Filtering

All filter parameters accept comma-separated values for multi-select. Array-style query params (e.g. priority[]=urgent&priority[]=high) are also accepted. 
GET /api/work-tasks?status=todo,in_progress&priority=urgent,high&due_date_to=2026-04-01
FilterValuesDescription
typetask, hil_approvalFilter by task type
statustodo, in_progress, in_review, done, canceledFilter by status
priorityurgent, high, medium, lowFilter by priority
assign_to_typeuser, agentFilter by assignee type
due_date_from / due_date_toISO 8601 dateFilter by due date range

​
Sorting

Default sort: due_date. Prefix with + for ascending or - for descending. Supported sort fields: title, due_date, priority, status, created_at, assign_to. 
GET /api/work-tasks?sort=-created_at&per_page=25

​
Response

{
  "status": "success",
  "status_code": 200,
  "message": "Work tasks retrieved",
  "data": {
    "items": [
      {
        "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "title": "Review Q4 invoice discrepancies",
        "type": "task",
        "status": "todo",
        "priority": "high",
        "due_date": "2026-04-01",
        "created_at": "2026-03-15T14:30:00Z",
        "assign_to": {
          "type": "user",
          "user_uid": "550e8400-e29b-41d4-a716-446655440000",
          "full_name": "Jane Smith",
          "avatar_url": "https://cdn.example.com/avatars/jane.jpg"
        },
        "origin": {
          "type": "user",
          "user_uid": "660e8400-e29b-41d4-a716-446655440000",
          "user_name": "John Doe",
          "avatar_url": "https://cdn.example.com/avatars/john.jpg"
        }
      },
      {
        "uid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "title": "Approve email to Acme Corp",
        "type": "hil_approval",
        "status": "todo",
        "priority": "urgent",
        "due_date": null,
        "created_at": "2026-03-16T09:15:00Z",
        "assign_to": null,
        "origin": {
          "type": "agent",
          "agent_uid": "770e8400-e29b-41d4-a716-446655440000",
          "agent_name": "Collections Agent"
        }
      }
    ],
    "_meta": {
      "page": 1,
      "per_page": 10,
      "total_pages": 3,
      "total_items": 24
    }
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
organization_uid
string<uuid>

Organization to scope the query to. Defaults to the user's default organization.

​
type
string

Comma-separated task types: task, hil_approval

​
status
string

Comma-separated statuses: todo, in_progress, in_review, done, canceled

​
priority
string

Comma-separated priorities: urgent, high, medium, low

​
assign_to_type
string

Comma-separated assignee types: user, agent

​
due_date_from
string<date>

Inclusive lower bound for due date

​
due_date_to
string<date>

Inclusive upper bound for due date

​
sort
string
default:due_date

Sort field. Prefix with + for ascending or - for descending. Options: title, due_date, priority, status, created_at, assign_to

​
page
integer
default:1
Required range: x >= 1
​
per_page
integer
default:10
Required range: 1 <= x <= 100

Response

Paginated work task list

​
status
string
Example:

"success"

​
status_code
integer
Example:

200

​
message
string
Example:

"Work tasks retrieved"

​
data
object