Read mature-content settings
GET /admin/system/mature-content
Returns the instance’s mature-content setting.
You need system.config.read or system.admin for the whole install; a permission held only for a team doesn’t count. Without one you get 403, and signed-out callers get 401. allowed is true until the setting has been saved. This endpoint reads the database directly and returns an error if that read fails.
Normally the shared mature-content check passes only for a signed-in viewer who has opted in, on an instance that allows mature content. The opt-in is off by default. An item’s signed-in owner and anyone with system.admin are exempt from that check, but the separate visibility and content-access rules still apply.
Turning the setting off keeps existing mature flags and account preferences. There’s no anonymous version of this endpoint. Authentication responses also include CurrentUser.mature_content_allowed as a display hint for clients, not an access decision. That hint falls back to true if its settings read fails, while the runtime viewer check falls back to a disqualified viewer when its lookup fails.
Authorizations
Section titled “Authorizations ”Responses
Section titled “ Responses ”The saved mature-content setting; allowed when it has never been set.
The instance-wide mature-content setting. It controls the instance’s part of the shared mature-content check and leaves saved flags and account preferences as they are.
object
True when the instance allows mature content, and the default until the setting is saved. Ordinary viewers must also be signed in and opted in. An item’s signed-in owner and anyone with system.admin are exempt from this check; separate access rules still apply. On writes, always send this field: omitting it or sending null currently counts as false, even though the schema marks it required.
Authentication required, missing, or invalid
object
Human-readable error summary
Example
the request could not be completedExample
{ "error": "authentication required: sign in and retry with a valid session or API token"}Authenticated but missing required capabilities
object
Human-readable error summary
Example
the request could not be completed