Skip to main content
GET
/
api
/
work-tasks
/
{task_uid}
Get work task
curl --request GET \
  --url https://dev.exante.app/api/work-tasks/{task_uid} \
  --header 'Authorization: Bearer <token>'
{
  "status": "success",
  "status_code": 200,
  "message": "<string>",
  "data": {
    "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>"
    },
    "description": "<string>",
    "updated_at": "2023-11-07T05:31:56Z",
    "context_entities": [
      {
        "entity_type": "invoice",
        "entity_uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      }
    ],
    "change_log": [
      {
        "at": "2023-11-07T05:31:56Z",
        "by_name": "<string>",
        "action": "<string>",
        "details": {}
      }
    ],
    "reasoning": "<string>",
    "tool_args": {},
    "trigger": {}
  }
}
Returns a single work task with the full detail payload, including hydrated context entities, change log, and — for HIL tasks — agent reasoning and tool arguments.

​
Task lookup

The endpoint searches across all organizations the authenticated user belongs to. No organization_uid parameter is needed.

​
Response for user tasks

User tasks (type: "task") include description, context entities, and a change log: 
{
  "status": "success",
  "status_code": 200,
  "message": "Work task retrieved",
  "data": {
    "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "title": "Review Q4 invoice discrepancies",
    "type": "task",
    "status": "in_progress",
    "priority": "high",
    "due_date": "2026-04-01",
    "description": "Check invoices flagged by the agent for amount mismatches against purchase orders.",
    "created_at": "2026-03-15T14:30:00Z",
    "updated_at": "2026-03-16T10:00: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"
    },
    "context_entities": [
      {
        "entity_type": "invoice",
        "entity_uid": "inv-uuid-here",
        "invoice_number": "INV-2026-0042",
        "counterparty_name": "Acme Corp"
      },
      {
        "entity_type": "party",
        "entity_uid": "party-uuid-here",
        "name": "Acme Corp"
      }
    ],
    "change_log": [
      {
        "at": "2026-03-16T10:00:00Z",
        "by_name": "Jane Smith",
        "by_type": "user",
        "action": "status_changed",
        "details": { "from": "todo", "to": "in_progress" }
      },
      {
        "at": "2026-03-15T14:30:00Z",
        "by_name": "John Doe",
        "by_type": "user",
        "action": "created",
        "details": null
      }
    ]
  }
}

​
Response for HIL approval tasks

HIL tasks (type: "hil_approval") include additional fields for the agent’s reasoning, tool arguments, and trigger context: 
{
  "status": "success",
  "status_code": 200,
  "message": "Work task retrieved",
  "data": {
    "uid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "title": "Approve email to Acme Corp",
    "type": "hil_approval",
    "status": "todo",
    "priority": "urgent",
    "due_date": null,
    "description": "",
    "created_at": "2026-03-16T09:15:00Z",
    "updated_at": "2026-03-16T09:15:00Z",
    "assign_to": null,
    "origin": {
      "type": "agent",
      "agent_uid": "770e8400-e29b-41d4-a716-446655440000",
      "agent_name": "Collections Agent"
    },
    "reasoning": "Invoice INV-2026-0042 is 15 days overdue. I've drafted a follow-up email to the billing contact at Acme Corp.",
    "tool_args": {
      "tool_type": "send_email",
      "subject": "Follow-up: Invoice INV-2026-0042 - Payment Overdue",
      "body": "Dear Acme Corp billing team,\n\nThis is a follow-up regarding...",
      "to": ["billing@acme.com"]
    },
    "resolution": "approved",
    "resolved_at": "2026-03-16T10:30:00Z",
    "resolved_by": {
      "type": "user",
      "user_uid": "550e8400-e29b-41d4-a716-446655440000",
      "user_name": "Jane Smith",
      "avatar_url": "https://www.gravatar.com/avatar/..."
    },
    "trigger": {
      "type": "email_received",
      "from_email": "support@acme.com",
      "subject": "RE: Invoice inquiry"
    },
    "context_entities": [],
    "change_log": [
      {
        "at": "2026-03-16T09:15:00Z",
        "by_name": "Collections Agent",
        "by_type": "agent",
        "action": "Created",
        "details": { "title": "..." }
      },
      {
        "at": "2026-03-16T10:30:00Z",
        "by_name": "Jane Smith",
        "by_type": "user",
        "action": "Resolved",
        "details": {
          "action": "approve",
          "resolution": "approved",
          "resolution_note": "Looks good, proceed"
        }
      }
    ]
  }
}
Use the reasoning field to display why the agent is requesting approval, and tool_args to show what action it wants to take. This lets the reviewer make an informed decision.

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
task_uid
string<uuid>
required

Work task UID

Response

Full work task detail

​
status
string
Example:

"success"

​
status_code
integer
Example:

200

​
message
string
​
data
object