Update task

PATCH

https://api.modulards.com/api/public/v1/site-tasks/:siteTask

PATCH

/api/public/v1/site-tasks/:siteTask

curl -X PATCH https://api.modulards.com/api/public/v1/site-tasks/siteTask \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "is_pending": false,
  "title": "Renew the SSL certificate (done)"
}'

200Update task

{
  "data": {
    "attributes": {
      "content": "<p>Renewed the certificate through the hosting panel.</p>",
      "created_at": "2026-09-17T09:00:00.000000Z",
      "date": "2026-09-17",
      "is_pending": false,
      "site_id": 12,
      "time_spent": 30,
      "title": "Renew the SSL certificate (done)",
      "updated_at": "2026-09-17T09:05:00.000000Z"
    },
    "id": "501",
    "links": {
      "self": "{{base_url}}/api/public/v1/site-tasks/501"
    },
    "type": "site-tasks"
  },
  "jsonapi": {
    "version": "1.1"
  }
}

Writes the given fields of one task; every field is optional (partial PATCH, no PUT). Path variable siteTask is the exact task id.

Body parameters:

title (string, optional): max 255 characters.
date (string, optional): Y-m-d.
content (string, nullable, optional): HTML, purified server-side, max 2500 characters after tags are stripped.
time_spent (number, nullable, optional): minutes spent, decimal allowed, minimum 0. Only ever a value the user gave.
is_pending (boolean, optional).
files (array, optional): up to 4 entries, [{uuid, name}]. Omitting files leaves the attachments untouched; sending files: [] removes every attachment. When present, it replaces the full set in one call: new uploads (from the “Uploads” folder) are moved in, uuids already on this task are kept and reordered, everything else is deleted.

Answers 200 with the updated site-tasks document.

422: an unknown or foreign files.*.uuid; a blank title when sent; an invalid date.
403: a read-only token.
404: a task of another organization, or a member without the site-tasks.update permission.

Writes the given fields of one task; every field is optional (partial `PATCH`, no `PUT`). Path variable `siteTask` is the exact task id. Body parameters: - `title` (string, optional): max 255 characters. - `date` (string, optional): `Y-m-d`. - `content` (string, nullable, optional): HTML, purified server-side, max 2500 characters after tags are stripped. - `time_spent` (number, nullable, optional): minutes spent, decimal allowed, minimum 0. Only ever a value the user gave. - `is_pending` (boolean, optional). - `files` (array, optional): up to 4 entries, `[{uuid, name}]`. **Omitting `files` leaves the attachments untouched; sending `files: []` removes every attachment.** When present, it replaces the full set in one call: new uploads (from the "Uploads" folder) are moved in, uuids already on this task are kept and reordered, everything else is deleted. Answers **200** with the updated `site-tasks` document. - **422**: an unknown or foreign `files.*.uuid`; a blank `title` when sent; an invalid `date`. - **403**: a read-only token. - **404**: a task of another organization, or a member without the `site-tasks.update` permission.

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