Schedule LinkedIn task

Schedule an existing LinkedIn task for its desired time. If send_at is omitted, scheduling uses the current time and may queue immediate execution, subject to task and integration constraints.

POST/api/task-queue/{task_id}/linkedin/schedule

HTTP referenceScope tasks:writeUpdated September 27, 2026

This page documents the canonical HTTP contract for this endpoint.

Path parameters

task_idrequired
string
LinkedIn task identifier.

Name	Type	Description
task_idrequired	string	LinkedIn task identifier.

Query parameters

actorUserId · optional
string
Optional actor override, subject to LinkedIn route authorization.

Name	Type	Description
actorUserId	string	Optional actor override, subject to LinkedIn route authorization.

Body parameters

send_at · optional
string<date-time>
Desired send time. If omitted, the route schedules from the current time subject to the task and LinkedIn schedule.

Name	Type	Description
send_at	string<date-time>	Desired send time. If omitted, the route schedules from the current time subject to the task and LinkedIn schedule.

Errors

Status	Meaning
401	Authentication is missing or invalid.
403	Missing tasks:write.
400	Task ID format is invalid, task is not a LinkedIn task, or LinkedIn is not connected.
404	Task or sequence enrollment not found.
409	Task is not schedulable or is no longer in a schedulable state.
503	LinkedIn integration is unavailable or not configured.

Example

bash

curl -X POST "https://app.autotouch.ai/api/task-queue/67c4a4f7b4dd8f2d4999f014/linkedin/schedule" \
  -H "Authorization: Bearer $AUTOTOUCH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"send_at":"2026-09-28T14:00:00Z"}'

Request body

json

{
  "send_at": "2026-09-28T14:00:00Z"
}

Response example

json

{
  "success": true,
  "task_id": "67c4a4f7b4dd8f2d4999f014",
  "execution_job": {
    "id": "linkedin-job-123"
  },
  "task_state": {},
  "scheduled_at": "2026-09-28T14:00:00Z"
}