Skip to navigation

Update a task

View as MarkdownOpen in Claude

Changes the fields you send on one task and leaves the others as they are. The id in the path is the task id.

Your role must be allowed to edit tasks; without it the request answers 404.

Body

  • title (string, optional): at most 255 characters, not blank.
  • date (string, optional): YYYY-MM-DD.
  • content (string or null, optional): HTML, cleaned on the server, at most 2500 characters once tags are stripped.
  • time_spent (number or null, optional): minutes spent, decimals allowed, 0 or more.
  • is_pending (boolean, optional): whether the task is still pending.
  • files (array, optional): up to 4 entries of {uuid, name}. Leaving files out keeps the attachments; sending [] removes all of them. When you send it, the list replaces the whole set: new uploads from “Upload a file” are attached, ids already on this task are kept and reordered, and everything else is removed.

Errors

  • 422: a files.*.uuid is unknown or was not uploaded by you, title is blank or date is invalid.

Authentication

AuthorizationBearer

Personal access token created in the Modular DS dashboard; read-only tokens can only call GET endpoints.

Path parameters

siteTaskstringRequired

Request

This endpoint expects an object.
is_pendingbooleanOptional
titlestringOptional

Response

200 OK
dataobjectOptional
jsonapiobjectOptional