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

Response Headers

X-Request-Id

Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.

400

The request syntax, headers, body, or validated input is malformed or invalid

Response Headers

X-Request-Id

Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.

401

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

Response Headers

X-Request-Id

Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.

403

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

Response Headers

X-Request-Id

Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.

404

The resource is unknown or outside the authenticated household scope

Response Headers

X-Request-Id

Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.

409

The request conflicts with the current resource, revision, lease, credential, or idempotency state

Response Headers

X-Request-Id

Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.

413

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

Response Headers

X-Request-Id

Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.

421

The request authority or direct peer is outside the configured Jiandu ingress boundary

Response Headers

X-Request-Id

Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.

422

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

Response Headers

X-Request-Id

Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.

503

A required core dependency is unavailable; retry with bounded backoff

Response Headers

X-Request-Id

Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.