NEnex
Tasks

Update a task

Changed on

Updates properties of an existing task. All fields are optional — only provided fields are updated.

patch/v1/tasks/{task_id}

Request

  • Base URL
    https://app.nex.ai/api/developers
  • Auth
    API key in header Authorization

Path parameters

task_idstring required

Task ID

Request body

titlestring

New title (cannot be empty)

descriptionstring

New description (empty string clears it)

priority'unspecified' | 'low' | 'medium' | 'high' | 'urgent' | ''

New priority (empty string clears it)

due_datestring date-time

New due date

is_completedboolean

Mark complete/incomplete

entity_idsstring[]

Replace associated records

assignee_idsstring[]

Replace assignees

Example request

{
  "title": "Updated title",
  "priority": "urgent",
  "is_completed": true,
  "entity_ids": [
    "1001"
  ],
  "assignee_ids": [
    "50",
    "51"
  ]
}

Response

Updated task

idstring
titlestring
descriptionstring
prioritystring
due_datestring date-time
is_completedboolean
completed_atstring date-time
assignee_idsstring[]
entity_idsstring[]
created_bystring
created_by_idstring
created_atstring date-time
archived_atstring date-time

Example response

{
  "id": "800",
  "title": "Follow up with client",
  "description": "Discuss contract renewal",
  "priority": "high",
  "due_date": "2026-03-01T09:00:00Z",
  "is_completed": false,
  "assignee_ids": [
    "50"
  ],
  "entity_ids": [
    "1001",
    "1002"
  ],
  "created_by": "developer_api",
  "created_by_id": "42",
  "created_at": "2024-01-15T10:00:00Z"
}

Changes