Skip to main content
PATCH
/
v1
/
tasks
/
{id}
curl -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 }'

{
  "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"
  }
}
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.
​
id
string
required
Task ID.
​
title
string
Task title (1-500 characters).
​
description
string | null
Task description (max 5,000 characters). Set to null to clear.
​
opportunity_id
string | null
Link to a CRM opportunity. Set to null to unlink.
​
property_id
string | null
Link to a property. Set to null to unlink.
​
person_id
string | null
Link to a person. Set to null to unlink.
​
assigned_to_user_id
integer | null
User ID to assign. Set to null to unassign.
​
is_completed
boolean
Set to true to complete, false to reopen.
​
due_date
string | null
Due date (ISO 8601). Set to null to clear.
​
sort_order
integer
Display order.
curl -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 }'

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