Reschedule email task - Autotouch AI

This page documents the canonical HTTP contract for this endpoint.

Path parameters

task_idrequired
string
Email task identifier.

Name	Type	Description
task_idrequired	string	Email 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

send_atrequired
string<date-time>
New scheduled send time.
provider · optional
string
Optional email provider.
provider_account_email · optional
string
Optional sender mailbox.
subject · optional
string
Updated subject.
body_text · optional
string
Updated plain-text content.
body_html · optional
string
Updated HTML content.
body_format · optional
string
auto (default) or explicit format.
thread_ref · optional
object
Provider thread reference.
context_tags · optional
array<object>
Context tags.
attachments · optional
array<object>
Attachment descriptors.

Name	Type	Description
send_atrequired	string<date-time>	New scheduled send time.
provider	string	Optional email provider.
provider_account_email	string	Optional sender mailbox.
subject	string	Updated subject.
body_text	string	Updated plain-text content.
body_html	string	Updated HTML content.
body_format	string	auto (default) or explicit format.
thread_ref	object	Provider thread reference.
context_tags	array<object>	Context tags.
attachments	array<object>	Attachment descriptors.

Errors

Status	Meaning
401	Authentication is missing or invalid.
403	Missing tasks:write.
400	Task ID format is invalid, task is not an email task, or task has no lead.
404	Task or associated lead not found.
409	Task requires action/review before scheduling.

Example

bash

curl -X POST "https://app.autotouch.ai/api/task-queue/67c4a4f7b4dd8f2d4999f014/email/reschedule?actorUserId=67c1dc35b4dd8f2d4999ed01" \
  -H "Authorization: Bearer $AUTOTOUCH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"send_at":"2026-09-28T14:00:00Z","provider":"gmail","provider_account_email":"rep@example.com","subject":"Updated subject","body_text":"Updated message","body_format":"auto"}'

Request body

json

{
  "send_at": "2026-09-28T14:00:00Z",
  "provider": "gmail",
  "provider_account_email": "rep@example.com",
  "subject": "Updated subject",
  "body_text": "Updated message",
  "body_format": "auto"
}

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": {}
}