Params

NameTypeRequirenessDefault valueDescription
task_uidstringrequirednoneUID of the task to update.
property_uidstringoptionalnoneUID of the property the task belongs to. Optional; only needed to move the task.
dtstringoptionalnoneYYYY-MM-DD date of the task. Only applied when provided.
tmstringoptionalnoneHH:MM:SS start time of the task. Only applied when provided.
hrfloatoptionalnoneTask duration in hours. Only applied when provided.
cleaner_uidstringoptionalnoneUID of the team member (cleaner) to assign. Only applied when provided.
descriptionstringoptionalnoneFree-text task description. Only applied when provided.

Description

Update an existing task by task_uid (reassign, reschedule, edit details). Only the provided fields are changed.

This endpoint requires the following scope: tasks

Request sample

{
    "task_uid": "485929487298347",
    "dt": "2026-07-26",
    "tm": "11:00:00",
    "cleaner_uid": "123234242342342343",
    "description": "Reassigned and rescheduled"
}

To unassign the current cleaner, send "cleaner_uid": "" (an empty string). Omitting the field or sending null preserves the current cleaner and does not clear it.

Response sample

{
    "data": [
        {
            "task_uid": "485929487298347",
            "team_member_uid": "123234242342342343"|null,
            "property_uid": "123123123",
            "task_type": <Dictionary: task_type>,
            "task_status": <Dictionary: task_status>,
            "description": "Getting rid of dust on the Wi-Fi router"|null,
            "local_start_dttm": "2019-01-12 06:00:00",
            "local_end_dttm": "2019-01-12 08:00:00"
        }
    ],
    "meta": {
        "page": 1,
        "has_next_page": true
    }
}