Sign in

v1

latestOpenAPI 3.0.12026-07-22120163333.7 KB
Tasks & Appointments V2

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.
put/v2.0/tasks/{taskId}

Path parameters

taskIdinteger required

ID of the task or appointment to update.

Headers

Authorizationstring required

Bearer [access_token]

Content-Typestring required

application/json

Request body

contentstring

Description of the task

startAtstring

When this task/appointment should start. ISO8601 format in specified timezone, e.g., '2026-03-01T15:00:00-08:00'

endAtstring

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

timeZoneCodestring

Timezone code for this task/appointment

addressstring

Address/location for appointment type tasks

Example request

{
  "content": "Send an email to my lead",
  "startAt": "2026-03-01T15:00:00-08:00",
  "endAt": "2026-03-01T16:00:00-08:00",
  "timeZoneCode": "America/Los_Angeles",
  "address": "123 Main St, Los Angeles, CA"
}

Response

Task updated. Response body is a simple message envelope.

messagestring

Result message

Example response

{
  "message": "Operation successful"
}