v1

latestOpenAPI 3.1.02026-07-263788129.7 KB
Tasks

Get a Task

Gets a single task by its task_id.

get/v1/tasks/{task_id}

Path parameters

task_idstring uuid required

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..."
    }
  }
}