Restrict a document or return it to shared-library visibility

PUT 
/api/v1/documents/:document_id/access

Requires documents.share, a current document-local manager grant, a browser same-origin proof for cookie requests, and PAT share when applicable. Restricting creates a durable owner-recovery manager grant and a designated active policy manager grant atomically.

Request

Responses

200

Updated policy and grant snapshot

400

The multipart shape or Idempotency-Key is malformed

401

The opaque credential is absent, ambiguous, malformed, expired, revoked, or invalid

403

The browser mutation did not originate from this application, or the authenticated member lacks the required permission

404

The resource is unknown or outside the authenticated household scope

413

A configured streaming body or per-file size limit was exceeded. A transport-level rejection may omit the JSON body.

422

The supplied bytes, filename, declared field value, or supported-content validation failed

503

A required core dependency is unavailable; retry with bounded backoff