Contents
On this page

Get Revision - Plugixa Image Map

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

Read one saved version of a map, with its document.

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/85

Path parameters

Name Type Description
id integer The map’s id
revision integer The revision’s id

Responses

200 OK. data is the revision.

{
  "success": true,
  "data": {
    "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",
    "doc": {
      "schema": 1,
      "image": {
        "attachment_id": 58,
        "width": 1600,
        "height": 1000,
        "alt": "Ground floor plan"
      },
      "settings": {
        "general": {
          "responsive": true
        },
        "tooltips": {
          "enabled": true,
          "trigger": "hover",
          "sticky": false,
          "constrain": true,
          "animation": "fade"
        },
        "effects": {
          "pageload": "none"
        },
        "zoom": {
          "enabled": false,
          "max": 4.0,
          "buttons": true,
          "wheel": "ctrl",
          "fullscreen": false
        },
        "list": {
          "enabled": false,
          "position": "right",
          "search": true,
          "title": ""
        }
      },
      "objects": [
        {
          "id": "o_3f9a1c2e",
          "type": "spot",
          "name": "Reception",
          "geometry": {
            "x": 42.5,
            "y": 61.25,
            "w": 3.0
          },
          "style": {
            "default": {
              "fill": "#1976d2",
              "fill_opacity": 0.4,
              "stroke": "#ffffff",
              "stroke_opacity": 1.0,
              "stroke_width": 0.0,
              "radius": 4.0,
              "opacity": 1.0,
              "icon": "pin",
              "icon_color": "#ffffff",
              "shadow": false
            },
            "hover": []
          },
          "action": {
            "type": "none",
            "new_tab": false,
            "url": "",
            "event": ""
          },
          "tooltip": {
            "enabled": true,
            "position": "auto",
            "width": 260,
            "offset_x": 0.0,
            "offset_y": 0.0,
            "content": "<p>Reception desk, open 8:00 to 18:00.</p>"
          },
          "a11y": {
            "label": "Reception",
            "description": ""
          },
          "visible": true,
          "locked": false,
          "group": "",
          "ext": []
        }
      ],
      "groups": [],
      "ext": []
    }
  }
}
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 object|null The document as it was kept, null if it cannot be read

Errors

Status Code When
404 plugixa_image_map_not_found No map with that id, or the map is in the trash.
404 plugixa_image_map_not_found No revision with that id on this map, or the id is an autosave.

Plus the errors every endpoint can return.

Examples

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

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

Quick Links

Share