tasks

Complete Task

Mark an actionable task as completed.

Requires the tasks:write scope on the API key.

post/v1/tasks/{task_id}/complete

Path parameters

task_idstring uuid required

ID of the task.

Request body

completion_source'TASK_EXECUTION' | 'EXTERNAL_CRM'

Response

Successful Response

idstring uuid required

Unique identifier.

organization_idstring uuid required

Workspace this task belongs to.

priority'HOT' | 'TODAY' | 'EXTRA' required

status'PENDING' | 'IN_PROGRESS' | 'COMPLETED' | 'SKIPPED' required

titlestring nullable

Task title for standalone tasks.

due_datestring date nullable

Due date for standalone tasks.

sequence_idstring uuid nullable required

Sequence run this task was projected from, if any.

assignee_user_idstring uuid nullable required

User the task is assigned to, if any.

reopened_atstring date-time nullable required

When the task was last reopened, if ever.

reopen_reason'REMINDER_RULE' required

snoozed_untilstring date-time nullable

When the task is snoozed until, if deferred.

skipped_atstring date-time nullable required

When the task was skipped, if applicable.

completed_atstring date-time nullable required

When the task was completed, if applicable.

created_atstring date-time required

When the task was created.

updated_atstring date-time required

When the task last changed.

Changes

Changed in 6 of the 12 revisions of this API.410

Aug 15, 202680f4fd40b75e1See the full diff
- ○
  added the optional property snoozed_until to the response with the 200 status
  response-optional-property-added
Aug 13, 20262f1c56db78f811See the full diff
- ●
  added the new WRONG_NUMBER enum value to the disposition/anyOf[subschema #1: CallDisposition]/ response property for the response status 200
  response-property-enum-value-added
- ○
  added the new WRONG_NUMBER enum value to the request property anyOf[subschema #1: CompleteTaskPublicInput]/disposition/anyOf[subschema #1: CallDisposition]/
  request-property-enum-value-added
Aug 6, 20262bd7bb8e3a3722See the full diff
- ●
  added the new INTERESTED enum value to the disposition/anyOf[subschema #1: CallDisposition]/ response property for the response status 200
  response-property-enum-value-added
- ●
  added the new NOT_INTERESTED enum value to the disposition/anyOf[subschema #1: CallDisposition]/ response property for the response status 200
  response-property-enum-value-added
- ○
  added the new INTERESTED enum value to the request property anyOf[subschema #1: CompleteTaskPublicInput]/disposition/anyOf[subschema #1: CallDisposition]/
  request-property-enum-value-added
- ○
  added the new NOT_INTERESTED enum value to the request property anyOf[subschema #1: CompleteTaskPublicInput]/disposition/anyOf[subschema #1: CallDisposition]/
  request-property-enum-value-added
Aug 5, 2026b390cd1c4e2a1See the full diff
- ○
  added optional request body
  request-body-added-optional
Aug 4, 2026467ce2bf692b5See the full diff
- ○
  added the optional property assignee to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property contact to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property due_date to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property sequence_template to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property title to the response with the 200 status
  response-optional-property-added
Jul 26, 202689675e210f341See the full diff
- ●
  added the new TODO enum value to the type response property for the response status 200
  response-property-enum-value-added

Full history