Sign in

v1

latestOpenAPI 3.0.0Proprietary2026-08-062711471.0 MB
User Tasks

Update a user task

Updates a task. Send only the fields to change. Pass due_date: null to clear the due date, or object_name: null + row_id: null to unlink the related object record. Requires a USER API key.

patch/public/v1/tasks/{taskId}

Path parameters

taskIdnumber nullable
Example:101

Request body

contentstring
due_datestring nullable

Pass null to clear the due date.

assignee_idsnumber[]
object_namestring nullable

Pass null (with row_id null) to unlink the object record.

row_idstring nullable

Example request

{
  "content": "example",
  "due_date": "example",
  "assignee_ids": [
    1
  ],
  "object_name": "example",
  "row_id": "example"
}

Response

Updated task

idnumber required
contentstring required
due_datestring nullable
completedboolean required
completed_atstring nullable
created_atstring required
updated_atstring required

Example response

{
  "id": 101,
  "content": "Email David Booth about Q3 renewal",
  "due_date": "2026-06-25T00:00:00Z",
  "created_at": "2026-06-01T12:00:00Z",
  "updated_at": "2026-06-01T12:00:00Z",
  "created_by": {
    "id": 42,
    "name": "Alvaro Vargas",
    "email": "alvaro@example.com"
  },
  "completed_by": {
    "id": 42,
    "name": "Alvaro Vargas",
    "email": "alvaro@example.com"
  },
  "assignees": [
    {
      "id": 42,
      "name": "Alvaro Vargas",
      "email": "alvaro@example.com"
    }
  ],
  "related": {
    "object_name": "companies",
    "object_label": "Companies",
    "row_id": "abc123"
  }
}