Skip to main content
PATCH
/
v1
/
tasks
/
{task_id}
Update Task
curl --request PATCH \
  --url https://api.trellistech.com/v1/tasks/{task_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "description": "<string>",
  "status": "<string>",
  "assigned_to": "<string>",
  "scheduled_date": "<string>",
  "scheduled_time": "<string>",
  "priority": "<string>",
  "estimated_duration_minutes": 123,
  "cost": 123,
  "currency": "<string>"
}
'
{
  "id": "<string>",
  "title": "<string>",
  "description": "<string>",
  "property_id": "<string>",
  "property_name": "<string>",
  "department": "<string>",
  "status": "<string>",
  "priority": "<string>",
  "assigned_to": {
    "id": "<string>",
    "name": "<string>"
  },
  "scheduled_date": "<string>",
  "scheduled_time": "<string>",
  "estimated_duration_minutes": 123,
  "cost": 123,
  "currency": "<string>",
  "created_at": "<string>",
  "updated_at": "<string>"
}
Updates the specified task by setting the values of the parameters passed. Any parameters not provided will remain unchanged.

​
Path Parameters

​
task_id
string
required
The unique identifier of the task to update.

​
Body Parameters

​
title
string
Updated task title.
​
description
string
Updated description or instructions.
​
status
string
Updated task status. One of: OPEN, SCHEDULED, IN_PROGRESS, COMPLETED, PENDING_APPROVAL.
​
assigned_to
string
User ID to assign or reassign the task to. Pass null to unassign.
​
scheduled_date
string
Updated scheduled date (YYYY-MM-DD format).
​
scheduled_time
string
Updated scheduled time (HH:MM format, 24-hour).
​
priority
string
Updated priority level. One of: low, normal, high, urgent.
​
estimated_duration_minutes
integer
Updated estimated duration in minutes.
​
cost
number
Updated cost for the task.
​
currency
string
Currency code for the cost (ISO 4217).

​
Example Request

curl -X PATCH \
  -H "Authorization: Bearer trls_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "status": "IN_PROGRESS",
    "assigned_to": "u1a2b3c4-1111-2222-3333-444444444444"
  }' \
  "https://api.trellistech.com/v1/tasks/t1a2b3c4-5678-9abc-def0-333333333333"

​
Response

Returns the updated task object with all fields.
​
id
string
Unique identifier for the task.
​
title
string
Task title.
​
description
string
Task description or instructions.
​
property_id
string
ID of the associated property.
​
property_name
string
Name of the associated property.
​
department
string
Department (e.g., “cleaning”, “maintenance”).
​
status
string
Current task status.
​
priority
string
Priority level: low, normal, high, urgent.
​
assigned_to
object
The assigned team member, if any.
​
scheduled_date
string
Scheduled date (YYYY-MM-DD).
​
scheduled_time
string
Scheduled time (HH:MM), if set.
​
estimated_duration_minutes
integer
Estimated duration in minutes.
​
cost
number
Cost associated with the task.
​
currency
string
Currency code (ISO 4217).
​
created_at
string
ISO 8601 timestamp of when the task was created.
​
updated_at
string
ISO 8601 timestamp of the last update.

​
Example Response

200
{
  "id": "t1a2b3c4-5678-9abc-def0-333333333333",
  "title": "Turnover cleaning - Sunset Villa",
  "description": "Full turnover clean before next guest arrival. Check linens, restock supplies.",
  "property_id": "a1b2c3d4-5678-9abc-def0-123456789abc",
  "property_name": "Sunset Villa",
  "department": "cleaning",
  "status": "IN_PROGRESS",
  "priority": "high",
  "assigned_to": {
    "id": "u1a2b3c4-1111-2222-3333-444444444444",
    "name": "Sofia Martinez"
  },
  "scheduled_date": "2026-04-10",
  "scheduled_time": "10:00",
  "estimated_duration_minutes": 120,
  "cost": 85.00,
  "currency": "USD",
  "created_at": "2026-04-05T07:00:00Z",
  "updated_at": "2026-04-05T10:15:00Z"
}

​
Error Responses

404
{
  "error": {
    "code": "not_found",
    "message": "No task found with the specified ID."
  }
}
400
{
  "error": {
    "code": "invalid_parameter",
    "message": "The 'status' parameter must be one of: OPEN, SCHEDULED, IN_PROGRESS, COMPLETED, PENDING_APPROVAL."
  }
}
401
{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key."
  }
}