Skip to main content
PATCH
/
v1
/
tasks
/
{task_id}
Update a task
curl --request PATCH \
  --url https://app.nex.ai/api/developers/v1/tasks/{task_id} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Updated title",
  "priority": "urgent",
  "is_completed": true,
  "entity_ids": [
    "1001"
  ],
  "assignee_ids": [
    "50",
    "51"
  ]
}
'
{
  "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"
}

Authorizations

Authorization
string
header
required

API key for authentication (format: "Bearer YOUR_API_KEY")

Path Parameters

task_id
string
required

Task ID

Body

application/json

Fields to update

title
string

New title (cannot be empty)

description
string

New description (empty string clears it)

priority
enum<string>

New priority (empty string clears it)

Available options:
unspecified,
low,
medium,
high,
urgent,
due_date
string<date-time>

New due date

is_completed
boolean

Mark complete/incomplete

entity_ids
string[]

Replace associated records

assignee_ids
string[]

Replace assignees

Response

Updated task

id
string
title
string
description
string
priority
string
due_date
string<date-time>
is_completed
boolean
completed_at
string<date-time>
assignee_ids
string[]
entity_ids
string[]
created_by
string
created_by_id
string
created_at
string<date-time>
archived_at
string<date-time>
Last modified on March 7, 2026