Prioritize email task

Prioritize an email task by scheduling its send for the current time. This can trigger immediate delivery through the personal email outbox; use only when the task is approved to send.

POST/api/task-queue/{task_id}/email/prioritize

HTTP referenceScope tasks:writeUpdated September 27, 2026

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 actor ID; LinkedIn routes enforce additional actor restrictions.

Name	Type	Description
actorUserId	string	Optional actor ID; LinkedIn routes enforce additional actor restrictions.

Errors

Status	Meaning
401	Authentication is missing or invalid.
403	Missing tasks:write.
400	Task ID is invalid or task channel does not match this route.
404	Task not found.

Example

bash

curl -X POST "https://app.autotouch.ai/api/task-queue/67c4a4f7b4dd8f2d4999f014/email/prioritize" \
  -H "Authorization: Bearer $AUTOTOUCH_API_KEY"

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