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,
    "from": 1,
    "last_page": 1,
    "links": [
      {
        "active": false,
        "label": "&laquo; Previous",
        "url": null
      },
      {
        "active": true,
        "label": "1",
        "url": "{{base_url}}/api/public/v1/site-tasks?page%5Bnumber%5D=1"
      },
      {
        "active": false,
        "label": "Next &raquo;",
        "url": null
      }
    ],
    "path": "{{base_url}}/api/public/v1/site-tasks",
    "per_page": 15,
    "to": 2,
    "total": 2
  }
}

Lists the tasks logged on the websites your token can reach, newest first. Use it to review the work done on a website over a period, for example with filter[site][] and a date range, or to find the tasks that are still pending.

Each task belongs to one website. To see the website or the attachments in the same answer, add them with include.

Authentication

AuthorizationBearer

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

Query parameters

filter[id][]stringOptional

Only these tasks, by task id. Several ids match any of them.

filter[site][]stringOptional

Only the tasks of these websites, by website id. Several ids match any of them. Every website your token can reach when omitted.

filter[s]stringOptional

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

filter[started_at]stringOptional

First day to include, as YYYY-MM-DD: tasks whose date is on or after it.

filter[ended_at]stringOptional

Last day to include, as YYYY-MM-DD: tasks whose date is on or before it.

filter[is_pending]stringOptional

1 for only the pending tasks, 0 for only the finished ones.

includestringOptional

Related data to return with each task. Accepted: site (the website) and files (the task's attachments). Separate several with commas.

sortstringOptional

Sort order. Accepted: created_at, date; a leading - reverses the order. Default -created_at, the most recently created first.

page[number]stringOptional

Page number, starting at 1.

page[size]stringOptional

Rows per page, up to 50 (default 15).

Response

200 OK

datalist of objectsOptional

jsonapiobjectOptional

linksobjectOptional

metaobjectOptional