Update Task

Update a task's details. Set is_completed to true to mark a task as done — this automatically records the completion timestamp and the completing user. You can also update the linked opportunity, property, or person references.

path idstringrequired

Task ID.

body titlestring

Task title (1-500 characters).

body descriptionstring | null

Task description (max 5,000 characters). Set to null to clear.

body opportunity_idstring | null

Link to a CRM opportunity. Set to null to unlink.

body property_idstring | null

Link to a property. Set to null to unlink.

body person_idstring | null

Link to a person. Set to null to unlink.

body assigned_to_user_idinteger | null

User ID to assign. Set to null to unassign.

body is_completedboolean

Set to true to complete, false to reopen.

body due_datestring | null

Due date (ISO 8601). Set to null to clear.

body sort_orderinteger

Display order.

Request example

1234curl -X PATCH "https://api.v2.dealmachine.com/v1/tasks/task_001" \
  -H "Authorization: Bearer dm_sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "is_completed": true }'

Response example

123456789101112131415161718192021{
  "data": {
    "id": "task_001",
    "organization_id": 1,
    "opportunity_id": "42",
    "property_id": "prop_12345",
    "person_id": null,
    "created_by_user_id": 5,
    "assigned_to_user_id": 12,
    "assigned_to_agent_id": null,
    "title": "Schedule property walkthrough",
    "description": "Contact seller to arrange a visit",
    "is_completed": true,
    "completed_at": "2026-03-05T10:30:00Z",
    "completed_by_user_id": 5,
    "due_date": "2026-03-10T00:00:00Z",
    "sort_order": 0,
    "created_at": "2026-03-01T09:00:00Z",
    "updated_at": "2026-03-05T10:30:00Z"
  }
}