Update Task
Partially updates a task or appointment. Only non-null fields in the request body are applied.
Notes:
- To mark an entry as completed or not, use the finish / unfinish endpoints instead.
- At least one of content, startAt, endAt, address must be supplied; an entirely empty payload returns 400 MISSING_PARAMETER.
- Caller must have manage permission on the entry’s lead.
Path Parameters
ID of the task or appointment to update.
x >= 1Body
Partial update payload. Only non-null fields are applied.
Description of the task
"Send an email to my lead"
When this task/appointment should start. ISO8601 format in specified timezone, e.g., '2026-03-01T15:00:00-08:00'
"2026-03-01T15:00:00-08:00"
When this task/appointment should end. ISO8601 format in specified timezone, e.g., '2026-03-01T16:00:00-08:00'. For regular tasks, this represents the deadline
"2026-03-01T16:00:00-08:00"
Timezone code for this task/appointment
"America/Los_Angeles"
Address/location for appointment type tasks
"123 Main St, Los Angeles, CA"
Response
Task updated. Response body is a simple message envelope.
Generic message response
Result message
"Operation successful"