Update a task
Partial update — the SAME operation the external MCP `update_task` tool executes: it writes a NEW immutable version carrying every omitted field (and the project links, attachments and collaborators) over from the current one. The change appears as a new entry in the task history.
Partial update — the SAME operation the external MCP update_task tool executes: it writes a NEW immutable version carrying every omitted field (and the project links, attachments and collaborators) over from the current one. The change appears as a new entry in the task history.
Authorization
bearerAuth A gid_ API key (Settings → API keys) or an OAuth 2.1 access token.
In: header
Path Parameters
Task short id, e.g. T-123 (a bare 123 is also accepted on input).
^(?:T-)?[0-9]{1,12}$Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Partial update — omitted fields keep their current value. Exactly the field set the external MCP update_task tool supports; description, project links and the parent are not updatable here (the shared update operation carries them over unchanged).
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X PATCH "https://example.com/v1/tasks/string" \ -H "Content-Type: application/json" \ -d '{}'{ "id": "string", "title": "string", "description": "string", "status": "TODO", "priority": "LOW", "start_date": "2019-08-24T14:15:22Z", "due_date": "2019-08-24T14:15:22Z", "notes": "string", "story_points": 0, "project_ids": [ "string" ], "parent_task_id": "string", "archived": true, "recurrence": { "frequency": "DAILY", "interval": -9007199254740991, "by_weekday": [ -9007199254740991 ], "by_month_day": -9007199254740991, "basis": "SCHEDULE", "timezone": "string", "start_date": "string", "end_date": "string", "max_occurrences": -9007199254740991, "rollover_enabled": true, "active": true, "rrule": "string" }, "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z"}Get a task GET
Fetches a single task by short id, scoped to the credential's organization. A short id from another organization (or an unknown one) answers 404 `resource_not_found` — no cross-org existence oracle.
Archive a task POST
Archives the task (hides it from active lists; no data is deleted) — the SAME operation the external MCP `archive_task` tool executes. Archiving an already-archived task succeeds unchanged. Supports the optional `Idempotency-Key` header.