Contents
On this page

List Revisions - Plugixa Image Map

GET /plugixa-image-map/v1/maps/{id}/revisions

The saved versions of a map, newest first: up to 100, without their documents.

Any signed-in user with the plugixa_image_map_view capability. Administrators have every Plugixa Image Map capability; see Roles and permissions.

Request

GET https://your-site.example/wp-json/plugixa-image-map/v1/maps/12/revisions

Path parameters

Name Type Description
id integer The map’s id

Responses

200 OK. data is the list of revisions.

{
  "success": true,
  "data": [
    {
      "id": 88,
      "map_id": 12,
      "rev": 5,
      "kind": "save",
      "label": "",
      "doc_hash": "3a7bd3e2360a3d29eea436fcfb7e44c735d117c4",
      "created_by": 1,
      "created_at": "2026-11-12 11:40:00",
      "author": "Alex Martin"
    },
    {
      "id": 85,
      "map_id": 12,
      "rev": 4,
      "kind": "manual",
      "label": "Before the reprint",
      "doc_hash": "3a7bd3e2360a3d29eea436fcfb7e44c735d117c4",
      "created_by": 1,
      "created_at": "2026-11-12 10:10:00",
      "author": "Alex Martin"
    },
    {
      "id": 84,
      "map_id": 12,
      "rev": 4,
      "kind": "save",
      "label": "",
      "doc_hash": "3a7bd3e2360a3d29eea436fcfb7e44c735d117c4",
      "created_by": 1,
      "created_at": "2026-11-12 10:05:00",
      "author": "Alex Martin"
    }
  ]
}
Field Type Meaning
data[].id integer The revision’s id
data[].map_id integer The map
data[].rev integer The map’s rev when this version was kept
data[].kind string save (kept on every save), manual (a checkpoint) or restore (kept when a revision was restored)
data[].label string The checkpoint’s name, or the restore note. Empty for plain saves
data[].doc_hash string A fingerprint of the document, equal for identical documents
data[].created_at string UTC datetime
data[].author string Display name of the user who made it, empty if that user is gone

Autosaves are never listed. Plain saves beyond the number the site keeps (30 by default, set under History and autosave) are removed; checkpoints and restores are kept. A save that changed nothing in the document adds no revision.

Errors

Status Code When
404 plugixa_image_map_not_found No map with that id, or the map is in the trash.

Plus the errors every endpoint can return.

Examples

curl -s "https://your-site.example/wp-json/plugixa-image-map/v1/maps/12/revisions" \
  -u "admin:$WP_APP_PASSWORD"

<?php
$ch = curl_init('https://your-site.example/wp-json/plugixa-image-map/v1/maps/12/revisions');
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 response = await fetch('https://your-site.example/wp-json/plugixa-image-map/v1/maps/12/revisions', {
  headers: {
    'Authorization': 'Basic ' + btoa(`admin:${process.env.WP_APP_PASSWORD}`),
  },
});
const { data } = await response.json();

Quick Links

Share