v1

latestOpenAPI 3.1.02026-08-069158174.8 KB
CRM Service Calls

Patch Task

Update an existing task by ID.

Send only the fields you want to change. Returns 400 if no fields are provided.

Path Parameters:

  • task_id: The task's CRM record ID.

Request Body (TaskUpdateRequest): Same fields as POST /tasks plus is_completed (bool) and completed_date (epoch timestamp). All optional — only included fields are updated.

Response: The updated task object.

patch/crm/tasks/{task_id}

Path parameters

task_idstring required

Request body

namestring nullable

Task title

descriptionstring nullable

Task details

statusstring nullable

Possible values: assigned, in-progress, rejected, reviewsubmit, reviewpass, completed

priorityinteger nullable

Priority 1=highest, 4=lowest

due_dateinteger nullable

Due date (epoch timestamp seconds)

is_completedboolean nullable

Mark task as completed

completed_dateinteger nullable

Completion date (epoch timestamp seconds)

subject_typestring nullable

Entity type linked to task

subjectstring nullable

Linked entity ObjectId

useridstring nullable

Assigned user ID

actionstring nullable

Task type

action_dataobject nullable

Action-specific details

tagsstring[] nullable

List of tags

Response

Successful Response

idstring required
namestring required
descriptionstring nullable
statusstring nullable
priorityinteger nullable
due_datestring nullable
is_completedboolean nullable
completed_datestring nullable
subject_typestring nullable
subjectstring nullable
useridstring nullable
created_by_useridstring nullable
actionstring nullable
action_dataobject nullable
tagsstring[] nullable
created_datestring nullable
updated_datestring nullable