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": "<string>",
  "start_date": "<string>"
}
'
{
  "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": []
}
Requires the tasks:write scope. Viewers cannot edit tasks.

​
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. Whitespace is trimmed. HTML is sanitized.
​
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
Due date in ISO 8601 UTC format (e.g., "2026-03-30T17:00:00Z").
​
start_date
string
Start date in ISO 8601 UTC format.

​
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.
{
  "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": []
}