List human tasks

A human task is something a person on the team does for one lead: a call, a voice note, a follow-up, a review or research. It comes from a human_task step of a flow (the sequence waits until the task has an outcome), after a positive or negative reply (branch on_reply of the flow), or you create one (a call script, a briefing). The user sees them under Human tasks in the menu, below the Inbox, and logs outcomes there or through you. These routes are the tools list_human_tasks, create_human_task and complete_human_task of the assistant server. A task is free; only finding a phone number (POST /person/phone) costs the normal price.

Authentication#

Send Authorization: Bearer gtk_…. Create the key under API keys in the menu. Every gtk_ key can call these routes, also while the Signals API is closed. A missing, invalid or revoked key is 401.

Query parameters#

• status string — open (due now, the default), upcoming (open, due later: a retry after no_answer), done or all. One of: open, upcoming, done, all.
• kind string — Only these kinds, comma-separated.
• owner string — me: only the tasks of the user behind the key. One of: me.
• limit integer — At most this many, 1 to 1000 (default 200).

Response#

• object string · required — Always list. One of: list.
• status string · required — The filter.
• total integer · required — How many tasks are in data.
• data object[] · required — The tasks, each as GET /human-tasks/{id} gives it.
• dashboard_url string · required — The Human tasks page.

Credits#

Free. This call never uses credits.

Errors#

• 400 invalid_request — A status, kind, owner or limit that is not valid.
• 401 authentication_error — The Authorization header is missing, or the key is unknown or revoked.
• 403 permission_error — API access is not part of your plan, or your account is suspended.
• 429 rate_limit_error — More than 60 requests per minute, or more than 3 at the same time, on one key. Wait for the Retry-After header.
• 503 service_unavailable — The API is temporarily unavailable. Retry later.
• 500 internal_error — Something went wrong on our side.

curl "https://mysdr.app/api/v1/human-tasks" \
  -H "Authorization: Bearer $MYSDR_API_KEY"

{
  "object": "list",
  "status": "open",
  "total": 1,
  "data": [
    {
      "object": "human_task",
      "id": "6f1c0f2e-4a1b-4d2e-9f6a-2b7c1d3e4f50",
      "source": "flow",
      "kind": "call",
      "instruction": "Call to ask whether the demo invite landed. Mention the funding round.",
      "reason": "No reaction after 3 days: step call_1 of flow cfo_after_funding.",
      "status": "open",
      "name": "Jane Example",
      "company": "Acme",
      "title": "CFO",
      "linkedin_url": "https://www.linkedin.com/in/jane-example",
      "email": null,
      "phone": "+32 470 12 34 56",
      "phone_needed": false,
      "due_at": "2026-10-29T09:00:00.000Z",
      "deadline_at": "2026-10-31T09:00:00.000Z",
      "overdue": false,
      "owner": {
        "id": "0b5a3c3e-1111-4c2e-9a3f-1234567890ab",
        "name": "Louis"
      },
      "attempts": 0,
      "max_attempts": 3,
      "outcome_note": null,
      "completed_at": null,
      "flow": "cfo_after_funding",
      "flow_step": "call_1",
      "campaign_id": null,
      "outreach_id": null,
      "row_id": null,
      "created_at": "2026-10-29T09:00:00.000Z",
      "via": null,
      "outcomes": {
        "done_positive": "the flow stops",
        "done_negative": "the flow stops",
        "no_answer": "the task comes back in 2 days",
        "skip": "the flow continues"
      },
      "dashboard_url": "https://mysdr.app/en/gtm/human-tasks?task=6f1c0f2e-4a1b-4d2e-9f6a-2b7c1d3e4f50"
    }
  ],
  "dashboard_url": "https://mysdr.app/en/gtm/human-tasks"
}