POST/v1/taskstasks:write

Create a task

Run a request

POST/v1/tasks

Base URL

Request body (JSON)

Resolved URL

POSThttps://coldos.justgotwyrd.com/api/v1/tasks

Paste an API key in the bar at the top of the page to enable Execute.

Parameters

Body parameters

titlestringrequired
Task title (one line).
contact_iduuidoptional
Contact this task is about.
assignee_iduuidoptional
Defaults to the API key's owner.
due_atiso8601optional
Due date/time (any timezone; rendered in IST in the UI).
priorityintegeroptionaldefault 0
0=none, 1=P1, 2=P2, 3=P3.
suggested_actionstringoptional
Surfaces a one-click row action in the UI.
callemailwhatsappmeetinglinkedin

Responses

400Invalid request — see `error.message`.
401Missing or invalid API key.
403Authenticated, but the key lacks the required scope.
404The referenced resource does not exist or is not visible to your key.
429Rate limit exceeded — see `Retry-After`.
500Unexpected server error. Safe to retry with idempotency-key.

Code samples

curl -X POST "https://coldos.justgotwyrd.com/api/v1/tasks" \
  -H "Authorization: Bearer $COLD_OS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "title": "Call Ankit to confirm Tuesday demo",
      "contact_id": "c2a8a93a-2f1c-4c5b-8f3d-9c1e3a8b5d12",
      "due_at": "2026-05-04T16:00:00.000+05:30",
      "priority": 1,
      "suggested_action": "call"
    }'

Response · 200

{
  "id": "5a8b3c2d-9e4f-1a2b-3c4d-5e6f7a8b9c0d",
  "title": "Call Ankit to confirm Tuesday demo",
  "description": "Confirm the 4 PM IST slot on the Tuesday before send.",
  "status": "open",
  "priority": 1,
  "due_at": "2026-05-04T16:00:00.000+05:30",
  "assignee_id": "b1f2c3d4-5678-90ab-cdef-1234567890ab",
  "contact_id": "c2a8a93a-2f1c-4c5b-8f3d-9c1e3a8b5d12",
  "suggested_action": "call",
  "flow_enrollment_id": null,
  "created_at": "2026-05-01T10:00:00.000+05:30"
}

Was this page helpful?

Your vote stays in this browser. We'll use it to prioritise rewrites.