Blueprints

Turn a sheet for display

Set how far the sheet is turned for display: rotation is 0, 90, 180 or 270 degrees clockwise, relative to the tiles as served. The value is absolute, so repeating a call changes nothing.

A view setting only. Tiles, the PDF, url_width/url_height, every geometry and the words stay exactly as they were, in the same coordinates, and so does revision: a base_revision read before the turn still saves. Apply rotation yourself when you draw the sheet, to the image and the overlays alike. auto_rotation (read-only) is how far Kamai already turned the page at upload; it is inside the tiles and geometry. To undo a wrong upload turn, set rotation to (360 - auto_rotation) % 360.

Any other value is refused with 422. The answer is the sheet as GET returns it.

put/v1/blueprints/{blueprint_id}/rotation

Request

  • Base URL: https://api.kamai.io (the document declares no server; this is the origin it was published from)
  • URL: https://api.kamai.io/v1/blueprints/{blueprint_id}/rotation
  • Auth: HTTP bearer

Path parameters

blueprint_idstring required

Request body

rotation0 | 90 | 180 | 270 required

Degrees clockwise to turn the sheet for display, relative to the tiles as served: 0, 90, 180 or 270. Absolute: sending the same value twice is a no-op.

Response

Successful Response

messagestring required

Update confirmation message

revisionstring nullable

The sheet's revision this copy was read at. Send it back as base_revision on a PUT that carries geojson: if the sheet changed in between, that save is refused with 409 stale_sheet instead of silently undoing the change. Opaque; compare for equality only.

Changes

No recorded changes to this operation across all 1 revision of this API.