Generate task draft - Autotouch AI

This page documents the canonical HTTP contract for this endpoint.

Draft generation model

Drafts are generated just-in-time when requested, then persisted onto the task content payload. The task must be an AI-generated sequence task with a valid sequence step; this endpoint invokes AI generation and changes the stored task content.

Used for manual-capable sequence steps when aiDraft=true.

Path parameters

task_idrequired
string
Task ID.

Name	Type	Description
task_idrequired	string	Task ID.

Query parameters

actorUserId · optional
string
Optional actor override.

Name	Type	Description
actorUserId	string	Optional actor override.

Body parameters

force · optional
boolean
Force regeneration of existing draft content; defaults to false.

Name	Type	Description
force	boolean	Force regeneration of existing draft content; defaults to false.

Errors

Status	Meaning
400	Invalid payload or actor.
401	Invalid API key or missing auth.
403	Missing tasks:write scope.
404	Task or sequence not found.
409	Draft generation is blocked by task orchestration state.

Example

bash

curl -X POST "https://app.autotouch.ai/api/task-queue/67c4d064b4dd8f2d4999f611/draft?actorUserId=<USER_ID>" \
    -H "Authorization: Bearer stk_your_key_id.your_secret" \
    -H "Content-Type: application/json" \
    -d '{"force":false}'

Request body

json

{
    "force": false
  }

Response example

json

{
    "id": "67c4d064b4dd8f2d4999f611",
    "organization_id": "org_123",
    "lead_id": "67c4b113b4dd8f2d4999f0f1",
    "assigned_to": "67c1dc35b4dd8f2d4999ed01",
    "due_date": "2026-04-25T09:00:00Z",
    "channel": "email",
    "content": {
      "type": "email",
      "subject": "Following up on your hiring plan",
      "body": "Hi Ada, ..."
    }
  }