Tasks
Update task status
Quick status update. Transitioning to “completed” auto-populates completedDate.
PUT
status. Setting completed auto-populates completedDate to now (if not already set).
Authentication
Requires a key with thetasks:write scope.
Path parameters
Task UUID.
Request body
One of
pending, in_progress, completed, overdue, cancelled.Response
Returns the updated task wrapped underdata.
Errors
| Status | When |
|---|---|
400 INVALID_ID | {id} is not a valid UUID |
400 VALIDATION_ERROR | status not in the allowed enum |
401 | Missing, malformed, expired, or revoked API key |
403 INSUFFICIENT_SCOPE | Key lacks tasks:write scope |
404 NOT_FOUND | Task doesn’t exist or belongs to another user |
429 RATE_LIMIT_EXCEEDED | Per-user rate limit reached |
5xx | Server error |