List tasks
query Parameters
sizePage size (max 100)
pageZero-based page index (default 0)
property_idRestrict to tasks for a single property
assigned_toFilter by assigned user id
statusFilter by task status (pending, in_progress, completed, cancelled)
task_typeFilter by task type (cleaning, maintenance, pool, gardening)
scheduled_fromOnly tasks scheduled on or after this date (ISO-8601)
scheduled_toOnly tasks scheduled on or before this date (ISO-8601)
include_cancelledInclude cancelled tasks when true (default false)
List tasks › Responses
Paginated tasks. When property_id is omitted, returns tasks from owned properties plus tasks assigned to the caller. Fields are filtered per the caller's access level (owner-only fields like booking_id, created_at, cancelled_at are hidden from crew); staff/contractor crew viewing a task not assigned to them receive a stripped item (id, from, to, property only).
Create task
Create task › Request Body
property_idtask_typefromtobooking_idassigned_tonotesCreate task › Responses
The created task
idtask_typestatusassigned_toassigned_to_namefromtocreated_atbooking_idnotesjob_reportstarted_atcompleted_atcancelled_ataccesspublic_tokenGet task
path Parameters
idTask id
Get task › Responses
The task. Staff/Contractor crew viewing a task that isn't assigned to them receive a stripped response (id, from, to, property only). Contractors viewing a cleaning task assigned to them receive the next-booking context embedded in the task.
idtask_typestatusassigned_toassigned_to_namefromtocreated_atbooking_idnotesjob_reportstarted_atcompleted_atcancelled_ataccesspublic_tokenUpdate task
Owners can update all fields. Managers and the assigned crew member can update job_report; other crew receive 403.
path Parameters
idTask id
Update task › Request Body
assigned_tonotesstatusjob_reportfromtoUpdate task › Responses
The updated task
idtask_typestatusassigned_toassigned_to_namefromtocreated_atbooking_idnotesjob_reportstarted_atcompleted_atcancelled_ataccesspublic_tokenStart task
Marks the task as in_progress. Only the assigned crew member or an owner can start a task, and the task must be in pending status.
path Parameters
idTask id
Start task › Responses
The task with its status set to in_progress
idtask_typestatusassigned_toassigned_to_namefromtocreated_atbooking_idnotesjob_reportstarted_atcompleted_atcancelled_ataccesspublic_tokenComplete task
Marks the task as completed. Only the assigned crew member or an owner can complete a task, and the task must be in in_progress status.
path Parameters
idTask id
Complete task › Responses
The task with its status set to completed
idtask_typestatusassigned_toassigned_to_namefromtocreated_atbooking_idnotesjob_reportstarted_atcompleted_atcancelled_ataccesspublic_tokenList property tasks
path Parameters
idProperty id
query Parameters
sizePage size (max 100)
pageZero-based page index (default 0)
statusFilter by task status
include_cancelledInclude cancelled tasks when true (default false)
List property tasks › Responses
Paginated tasks for the property. Fields are filtered per the caller's access level (owner-only fields like booking_id, created_at, cancelled_at are hidden from crew); staff/contractor crew viewing a task not assigned to them receive a stripped item (id, from, to, property only).
Get task by public token
Unauthenticated access for contractors via a shareable link. The token expires 7 days after the task's scheduled date.
path Parameters
tokenPublic task token
Get task by public token › Responses
The task, rendered with contractor-level visibility
idtask_typestatusassigned_toassigned_to_namefromtocreated_atbooking_idnotesjob_reportstarted_atcompleted_atcancelled_ataccesspublic_token