List tasks

GET

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

GET

/api/public/v1/site-tasks

curl https://api.modulards.com/api/public/v1/site-tasks \
     -H "Authorization: Bearer <token>"

200200 OK

{
  "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",
        "updated_at": "2026-09-17T09:00:00.000000Z"
      },
      "id": "501",
      "links": {
        "self": "{{base_url}}/api/public/v1/site-tasks/501"
      },
      "type": "site-tasks"
    },
    {
      "attributes": {
        "content": null,
        "created_at": "2026-09-15T14:20:00.000000Z",
        "date": "2026-09-15",
        "is_pending": true,
        "site_id": 13,
        "time_spent": null,
        "title": "Update the caching plugin",
        "updated_at": "2026-09-15T14:20:00.000000Z"
      },
      "id": "487",
      "links": {
        "self": "{{base_url}}/api/public/v1/site-tasks/487"
      },
      "type": "site-tasks"
    }
  ],
  "jsonapi": {
    "version": "1.1"
  },
  "links": {
    "first": "{{base_url}}/api/public/v1/site-tasks?page%5Bnumber%5D=1",
    "last": "{{base_url}}/api/public/v1/site-tasks?page%5Bnumber%5D=1",
    "next": null,
    "prev": null
  },
  "meta": {
    "current_page": 1,
    "per_page": 15,
    "total": 2
  }
}

Lists the tasks logged on every website the token can reach, as a JSON:API collection of type site-tasks with the usual links / meta pagination. Each entry carries site_id (so a flat page of tasks can be grouped by website without resolving the site include), title, content, date (Y-m-d, no time component), is_pending, time_spent (minutes, null when not given), created_at and updated_at.

include=files adds the task’s attachments as media resources; include=site adds the website.

Websites of other organizations answer 404; an unknown filter answers 400 and an invalid value 422. A read-only token is enough. There is no MCP twin of included attachments: the MCP site-tasks-index tool answers a flat view instead.

Lists the tasks logged on every website the token can reach, as a JSON:API collection of type `site-tasks` with the usual `links` / `meta` pagination. Each entry carries `site_id` (so a flat page of tasks can be grouped by website without resolving the `site` include), `title`, `content`, `date` (`Y-m-d`, no time component), `is_pending`, `time_spent` (minutes, `null` when not given), `created_at` and `updated_at`. `include=files` adds the task's attachments as `media` resources; `include=site` adds the website. Websites of other organizations answer 404; an unknown filter answers 400 and an invalid value 422. A read-only token is enough. There is no MCP twin of `include`d attachments: the MCP `site-tasks-index` tool answers a flat view instead.

Authentication

AuthorizationBearer

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

Query parameters

filter[id][]stringOptional

Exact task ids (repeatable)

filter[site][]stringOptional

Exact website ids; every reachable website when omitted (repeatable)

filter[s]stringOptional

Free-text search over the title, content and time spent

filter[started_at]stringOptional

Y-m-d; inclusive lower bound on the task’s date

filter[ended_at]stringOptional

Y-m-d; inclusive upper bound on the task’s date

filter[is_pending]stringOptional

1|0

includestringOptional

site - the website; files - the task’s attachments

sortstringOptional

created_at (default, descending), date; prefix with - to invert

page[number]stringOptional

page[size]stringOptional

Max 50

Response

200 OK

datalist of objectsOptional

jsonapiobjectOptional

linksobjectOptional

metaobjectOptional