List History - Plugixa Advanced User Role Editor for WordPress

List History - Plugixa Advanced User Role Editor

GET /plugixa-aure/v1/history

The History list: the most recent restore points, newest first, each with what the change after it did to roles and people, and whether restoring it would change anything today.

Needs the Edit roles permission: plugixa_aure_edit_roles.

Request

GET https://your-site.example/wp-json/plugixa-aure/v1/history?per_page=20

Query parameters

Name	Type	Default	Description
`per_page`	`integer`	`50`	How many to return, 1 to 200. There is no `page`.

Responses

`200` OK. `data` is the list.

{
  "success": true,
  "data": [
    {
      "id": 42,
      "createdAt": "2026-11-12T09:30:00Z",
      "actor": "Sam Carter",
      "kind": "auto",
      "operation": "changes.apply",
      "label": "",
      "restores": null,
      "roles": [
        {
          "role": "editor",
          "name": "Editor",
          "granted": [
            "install_plugins"
          ],
          "revoked": [],
          "denied": [],
          "cleared": []
        }
      ],
      "users": [
        {
          "user": 12,
          "name": "Maria Lopez",
          "rolesBefore": [
            "author"
          ],
          "rolesAfter": [
            "author",
            "editor"
          ],
          "granted": [
            "switch_themes"
          ],
          "revoked": [],
          "denied": [],
          "cleared": []
        }
      ],
      "restorable": true
    }
  ]
}

Field	Type	Meaning
`data[].id`	`integer`	The restore point’s id
`data[].createdAt`	`string`	UTC time, ISO 8601. Not the same format as List Snapshots
`data[].actor`	`string`	Display name of who caused it
`data[].kind`	`string`	`auto`, `manual`, `activation` or `restore`
`data[].operation`	`string`	The change that caused it
`data[].label`	`string`	Its label, if any
`data[].restores`	`integer\|null`	For a `restore` point, the id of the point that was restored
`data[].roles[]`	`array`	What the change did to each role, as in Restore Snapshot
`data[].users[]`	`array`	What it did to each account
`data[].restorable`	`boolean`	`false` when the site already matches the point, so restoring would change nothing

Errors

Plus the errors every endpoint can return.

Examples

curl -s "https://your-site.example/wp-json/plugixa-aure/v1/history?per_page=20" \
  -u "admin:$WP_APP_PASSWORD"

<?php
$query = http_build_query([
    'per_page' => '20',
]);
$ch = curl_init('https://your-site.example/wp-json/plugixa-aure/v1/history?' . $query);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_USERPWD        => 'admin:' . getenv('WP_APP_PASSWORD'),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

const query = new URLSearchParams({ per_page: '20' });
const response = await fetch(`https://your-site.example/wp-json/plugixa-aure/v1/history?${query}`, {
  headers: {
    'Authorization': 'Basic ' + btoa(`admin:${process.env.WP_APP_PASSWORD}`),
  },
});
const { data } = await response.json();