Get task

Get a single task by ID with live lead, company, and research data.

GET/api/task-queue/{task_id}

HTTP referenceScope tasks:readUpdated April 25, 2026

This page documents the canonical HTTP contract for this endpoint.

Path parameters

task_idrequired
string
Task ID.

Name	Type	Description
task_idrequired	string	Task ID.

Errors

Status	Meaning
401	Invalid API key or missing auth.
403	Missing tasks:read scope.
404	Task not found.

Example

bash

curl -X GET "https://app.autotouch.ai/api/task-queue/67c4d064b4dd8f2d4999f611" \
    -H "Authorization: Bearer stk_your_key_id.your_secret"

Response example

json

{
    "id": "67c4d064b4dd8f2d4999f611",
    "organization_id": "org_123",
    "lead_id": "67c4b113b4dd8f2d4999f0f1",
    "assigned_to": "67c1dc35b4dd8f2d4999ed01",
    "task_status": "pending",
    "channel": "email",
    "due_date": "2026-04-25T09:00:00Z",
    "lead": {
      "first_name": "Ada",
      "last_name": "Lovelace",
      "email": "ada@analyticalengines.com"
    },
    "company": {
      "name": "Analytical Engines",
      "domain": "analyticalengines.com"
    },
    "research_values": {
      "col_456": "Renewal risk"
    }
  }