Replace a saved presentation document
Required scopes: presentation.update.
Full document replacement retaining supplied slide/element IDs; body accepts document only, not revision. Requires current document If-Match and returns an incremented revision and new ETag, including for identical saves. Current explicit scope, status/processing, ownership and precondition are checked under the workspace lock shared by browser edits, publication and credential changes. Invalid documents/media references return 422; slide/allocation exhaustion returns 409. Transport limit is 2,016,384 bytes; document limit is 2,000,000 encoded JSON bytes. Other REST controls retain their 16 KiB limit. Saving never changes a published Live snapshot.
Response headers:
ETag(200): Strong validator covering presentation ID, organization, revision and rights-normalized document. Browser/editor saves and changed effective rights notices invalidate it.
Authentication
Organization-owned service token. Issue the initial token in organization credential settings. Scopes are documented per operation via x-required-scopes; they are not OAuth scopes.
Path parameters
Immutable presentation UUID; missing, personal or foreign organization resources return 404.
Headers
Strong validator covering presentation ID, organization, revision and rights-normalized document. Browser/editor saves and changed effective rights notices invalidate it. Missing:428; stale:412; malformed/weak/wildcard/list:422.
Request
Version-1 document, at most 2,000,000 encoded JSON bytes. Slide IDs are unique across the deck, element IDs within each slide. Omitted slide background is preserved as omitted. Save retains caller slide/element IDs; no automatic publishing. Existing same-workspace ready media references are checked by the domain; upload and portable import endpoints provide ready media. Uploading alone never modifies the saved document.
Response headers
Strong validator covering presentation ID, organization, revision and rights-normalized document. Browser/editor saves and changed effective rights notices invalidate it.
Response
Version-1 document, at most 2,000,000 encoded JSON bytes. Slide IDs are unique across the deck, element IDs within each slide. Omitted slide background is preserved as omitted. Save retains caller slide/element IDs; no automatic publishing. Existing same-workspace ready media references are checked by the domain; upload and portable import endpoints provide ready media. Uploading alone never modifies the saved document.