Create a household custom role

POST 
/api/v1/authorization/roles

Requires roles.manage and an exact same-origin browser mutation proof. Every requested permission must be one the acting member already has; built-in roles remain immutable.

Request

Responses

201

Custom role created

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

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