{"version":"0.20.0","name":"kanvas_pins","description":"Named bookmarks of a display position: save, recall, remove, list. Required: operation. Required fields by operation: save(sessionId,displayId,requestId,label); recall(sessionId,displayId,requestId,pinId,expectedRevision); remove(sessionId,displayId,pinId); list(sessionId,displayId).","inputSchema":{"type":"object","properties":{"operation":{"type":"string","enum":["save","recall","remove","list"],"description":"Required operation; supply only the fields in its matching branch."},"sessionId":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9_-]+$"},"displayId":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9_-]+$"},"requestId":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9_-]+$"},"label":{"type":"string","minLength":1,"maxLength":120},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"pinId":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9_-]+$"},"expectedRevision":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["operation"],"oneOf":[{"properties":{"operation":{"const":"save"},"sessionId":{},"displayId":{},"requestId":{},"label":{},"revision":{}},"required":["operation","sessionId","displayId","requestId","label"],"additionalProperties":false,"description":"Bookmark current or retained view with a label without publishing."},{"properties":{"operation":{"const":"recall"},"sessionId":{},"displayId":{},"requestId":{},"pinId":{},"expectedRevision":{}},"required":["operation","sessionId","displayId","requestId","pinId","expectedRevision"],"additionalProperties":false,"description":"Return to pinned content via normal revision-safe history."},{"properties":{"operation":{"const":"remove"},"sessionId":{},"displayId":{},"pinId":{}},"required":["operation","sessionId","displayId","pinId"],"additionalProperties":false,"description":"Remove the bookmark, not the displayed content."},{"properties":{"operation":{"const":"list"},"sessionId":{},"displayId":{}},"required":["operation","sessionId","displayId"],"additionalProperties":false}],"examples":[{"operation":"save","sessionId":"s","displayId":"d","requestId":"r0","label":"Options to revisit"},{"operation":"recall","sessionId":"s","displayId":"d","pinId":"pin-id","requestId":"r1","expectedRevision":4},{"operation":"remove","sessionId":"s","displayId":"d","pinId":"pin-id"},{"operation":"list","sessionId":"s","displayId":"d"}]},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true}}