Grant document-local viewer, editor, or manager access

POST 
/api/v1/documents/:document_id/access/grants

Requires documents.share, a current document-local manager grant, a restricted policy, active direct recipients or a group with an active member, and PAT share when applicable. Grant changes are durably audited.

Request

Responses

201

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

409

Duplicate content is disallowed, or an idempotency key was reused for a different request

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