Queue task with content

This page documents the canonical HTTP contract for this endpoint.

Path parameters

task_idrequired
string
Task identifier.

Name	Type	Description
task_idrequired	string	Task identifier.

Query parameters

actorUserId · optional
string
Optional active same-organization actor override.

Name	Type	Description
actorUserId	string	Optional active same-organization actor override.

Body parameters

action · optional
string
schedule (default), prioritize, or reschedule.
content · optional
object
Optional task content object.
draft_feedback · optional
object
Optional inline draft feedback: feedback_text and learn_mode (default, learn, ignore, or avoid_pattern).
send_at · optional
string<date-time>
Optional scheduled time.
provider · optional
string
Email provider.
provider_account_email · optional
string
Sender mailbox.
subject · optional
string
Email subject.
body_text · optional
string
Plain-text body.
body_html · optional
string
HTML body.
body_format · optional
string
Body format; defaults to auto.
thread_ref · optional
object
Provider thread reference.
context_tags · optional
array<object>
Context tags.
attachments · optional
array<object>
Attachment descriptors.

Name	Type	Description
action	string	schedule (default), prioritize, or reschedule.
content	object	Optional task content object.
draft_feedback	object	Optional inline draft feedback: feedback_text and learn_mode (default, learn, ignore, or avoid_pattern).
send_at	string<date-time>	Optional scheduled time.
provider	string	Email provider.
provider_account_email	string	Sender mailbox.
subject	string	Email subject.
body_text	string	Plain-text body.
body_html	string	HTML body.
body_format	string	Body format; defaults to auto.
thread_ref	object	Provider thread reference.
context_tags	array<object>	Context tags.
attachments	array<object>	Attachment descriptors.

Errors

Status	Meaning
401	An authenticated user session is required.
400	Task channel is not queue-managed or send_at is required for reschedule.
404	Task not found.
409	The task cannot perform the requested action in its current state.

Example

bash

curl -X POST "https://app.autotouch.ai/api/task-queue/67c4a4f7b4dd8f2d4999f014/queue-with-content" \
  -H "Authorization: Bearer $AUTOTOUCH_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action":"schedule","subject":"Following up","body_text":"Hello Alex","body_format":"auto","send_at":"2026-09-28T14:00:00Z"}'

Request body

json

{
  "action": "schedule",
  "subject": "Following up",
  "body_text": "Hello Alex",
  "body_format": "auto",
  "send_at": "2026-09-28T14:00:00Z"
}

Response example

json

{
  "success": true,
  "task_id": "67c4a4f7b4dd8f2d4999f014",
  "outbox_id": "outbox-123",
  "outbox_status": "scheduled",
  "queued_for_send": true,
  "send_at": "2026-09-28T14:00:00Z",
  "outbox": {
    "status": "scheduled"
  },
  "task_completion": null,
  "task_state": {}
}