v1

latestOpenAPI 3.1.02026-07-263788129.7 KB
Tasks

List Tasks

Returns a paginated list of tasks.

post/v1/tasks/list

Request body

pageinteger

Page number (1-indexed)

page_sizeinteger

Number of results per page

sortstring

Field to sort by. Prefix with '-' for descending order.

Response

Successful Response

Example response

{
  "data": [
    {
      "id": "tsk_abc123",
      "account_id": "acc_def456",
      "opportunity_id": "opp_ghi789",
      "title": "Send follow-up proposal",
      "description": "Send the updated pricing proposal to the procurement team",
      "task_type": "General Action Item",
      "assignee": {
        "id": "usr_abc123",
        "first_name": "Jane",
        "last_name": "Smith"
      },
      "status": "To Do",
      "due_at": "2025-07-01T17:00:00Z",
      "completed_at": "2025-06-28T11:00:00Z",
      "created_at": "2025-06-15T10:30:00Z",
      "updated_at": "2025-06-16T10:30:00Z",
      "message_draft": {
        "recipients": [
          {
            "name": "Jane Smith",
            "email": "jane@acme.com"
          }
        ],
        "cc": [
          {
            "name": "Jane Smith",
            "email": "jane@acme.com"
          }
        ],
        "subject": "Pricing follow-up",
        "body": "Hi Jane, following up on the proposal we discussed..."
      }
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 25,
    "total_count": 142,
    "total_pages": 6
  }
}