Create a one-use household membership invitation
POST/api/v1/members/invitations
Requires members.manage and an exact same-origin proof for cookie requests. The raw invitation token is returned only in this 201 response; Jiandu stores only a domain-separated verifier. The requested role must be an existing household role and may not grant any permission the creator lacks.
Request
Responses
- 201
- 400
- 401
- 403
- 413
- 421
- 422
- 503
One-use invitation created; copy its raw token now
Response Headers
Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.
The request syntax, headers, body, or validated input is malformed or invalid
Response Headers
Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.
The opaque credential is absent, ambiguous, malformed, expired, revoked, or invalid
Response Headers
Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.
The browser mutation did not originate from this application, or the authenticated member lacks the required permission
Response Headers
Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.
A configured streaming body or per-file size limit was exceeded. A transport-level rejection may omit the JSON body.
Response Headers
Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.
The request authority or direct peer is outside the configured Jiandu ingress boundary
Response Headers
Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.
The supplied bytes, filename, declared field value, or supported-content validation failed
Response Headers
Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.
A required core dependency is unavailable; retry with bounded backoff
Response Headers
Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.