Skip to main content
PATCH
/
api
/
v1
/
tasks
/
{id}
Update task
curl --request PATCH \
  --url https://api.getarca.app/api/v1/tasks/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "description": "<string>",
  "priority": "<string>",
  "status_id": "<string>",
  "list_id": "<string>",
  "due_date": {},
  "start_date": {},
  "assignee_ids": [
    {}
  ],
  "custom_fields": [
    {}
  ]
}
'
{
  "id": 110,
  "workspace_id": 3,
  "list_id": 20,
  "title": "Write unit tests",
  "description": "<p>Cover all service layer methods.</p>",
  "priority": "urgent",
  "identifier": 14,
  "due_date": "2026-03-22T09:00:00.000Z",
  "start_date": null,
  "creator_id": 1,
  "created_at": "2026-03-18T18:00:00.000Z",
  "status": {
    "id": 1,
    "name": "To Do",
    "icon": "todo",
    "color": "gray",
    "category": "pending"
  },
  "assignees": [
    {
      "id": 7,
      "name": "Alice",
      "avatar_url": null
    }
  ],
  "custom_fields": [
    {
      "id": 1,
      "name": "Customer Tier",
      "type": "dropdown",
      "config": { "options": ["Free", "Starter", "Pro"] },
      "position": 1,
      "value": "Starter"
    }
  ]
}
Requires the tasks:write scope. Viewers cannot edit tasks. Access-restricted members receive 403 if the task belongs to, or is being moved to, a list outside their permitted scope.

​
Path parameters

​
id
string
required
The numeric task ID.

​
Request body

All fields are optional. Send only the fields you want to update.
​
title
string
New task title. Cannot be set to an empty string.
​
description
string
Task description as an HTML string.
​
priority
string
Task priority. Must be one of urgent, high, medium, low, or none.
​
status_id
string
Numeric ID of a workspace status to apply. The status must belong to the same workspace.
​
list_id
string
Numeric ID of a list to move the task into. The list must belong to the same workspace.
​
due_date
string | null
Due date in ISO 8601 UTC format (e.g., "2026-03-30T17:00:00Z"). Pass null or an empty string to remove the due date.
​
start_date
string | null
Start date in ISO 8601 UTC format. Pass null or an empty string to remove the start date.
​
assignee_ids
array
Array of numeric user IDs to assign to the task. Replaces the current assignees entirely. Pass an empty array to remove all assignees. Omit this field to leave the current assignees unchanged. All IDs must be members of the same workspace; non-member IDs are silently ignored.
​
custom_fields
array
Optional array of custom field values to update. Each entry must contain a numeric id and a string value (or null to clear that field’s value). Omitting this field entirely leaves all custom field values unchanged. Only fields that apply to the task’s list and are visible to the API key user are processed; other fields are silently ignored.
"custom_fields": [
  { "id": 1, "value": "Starter" },
  { "id": 2, "value": null }
]

​
Response

Returns the full updated task including its current assignees.
​
id
number
required
Task identifier.
​
workspace_id
number
required
Workspace this task belongs to.
​
list_id
number | null
List this task belongs to.
​
title
string
required
Task title.
​
description
string | null
Task description.
​
priority
string
required
Task priority.
​
identifier
number
required
Workspace-scoped sequential task number.
​
due_date
string | null
UTC ISO-8601 due date.
​
start_date
string | null
UTC ISO-8601 start date.
​
creator_id
number
required
User ID of the task creator.
​
created_at
string
required
UTC ISO-8601 creation timestamp.
​
status
object | null
Current task status.
​
assignees
array
required
Current assignees. Empty array if unassigned.
​
custom_fields
array
required
Custom fields that apply to the task’s list, each with its current value after the update. Fields the user does not have access to are not returned.
{
  "id": 110,
  "workspace_id": 3,
  "list_id": 20,
  "title": "Write unit tests",
  "description": "<p>Cover all service layer methods.</p>",
  "priority": "urgent",
  "identifier": 14,
  "due_date": "2026-03-22T09:00:00.000Z",
  "start_date": null,
  "creator_id": 1,
  "created_at": "2026-03-18T18:00:00.000Z",
  "status": {
    "id": 1,
    "name": "To Do",
    "icon": "todo",
    "color": "gray",
    "category": "pending"
  },
  "assignees": [
    {
      "id": 7,
      "name": "Alice",
      "avatar_url": null
    }
  ],
  "custom_fields": [
    {
      "id": 1,
      "name": "Customer Tier",
      "type": "dropdown",
      "config": { "options": ["Free", "Starter", "Pro"] },
      "position": 1,
      "value": "Starter"
    }
  ]
}