Get Registration Policy
Read the current registration policy for an endpoint — how new users can join. The policy is a set of boolean toggles plus domain/role/password constraints rather than a single enum:
allow_self_registration— whenfalse, no self-registration at all; admins must create users via API.invite_only— registration is gated; users need an invite link to join.auto_approve— new users become active immediately rather than waiting for admin approval. Withinvite_only: trueit doesn't apply to invites: the invite is the approval.
When no policy has been saved yet, the endpoint returns the safe defaults invite_only: true, auto_approve: false, and the default password requirements.
Path parameters
uuid string (uuid) Req
The endpoint's
uuid from /endpoints.Response (200 OK)
allow_self_registration boolean
Whether users can self-register at all.
invite_only boolean
Registration requires a valid invite token.
auto_approve boolean
New self-registered users become active immediately.
require_email_verification boolean
People who join with an invite link you copy confirm their email before they get access. Emailed invites and sign-ups prove the address already.
signup_form boolean
The sign-up form: with sign-ups open (
allow_self_registration: true, invite_only: false), the endpoint's sign-in page shows No account? Sign up and new users sign up with their name, email and a password, confirming their email first. false until you turn it on.signup_sso boolean
New users can join by continuing with single sign-on while sign-ups are open.
true unless you turned it off.default_role_uuid string (uuid) | null
The role every new user gets, whoever adds them: you (dashboard, API, CLI, MCP), an invite, a sign-up or single sign-on. It is one setting: a role's
is_default shows the same role. null: new users get no role. An endpoint that had several default roles before keeps them until you pick one; this then shows the sign-up default role it had, or null.allowed_domains string[] | null
Restrict registration to these email domains (e.g.
["example.com"]). Empty or null (never set) = no restriction.blocked_domains string[] | null
Email domains that are rejected from registering.
null when never set.oauth_providers string[] | null
Which OAuth providers (by
provider_type) may auto-register new users on first login. Empty or null (never set) = all configured providers.forwarding_config object | null
The headers and cookies your app receives after sign-in. A new sign-in setup starts with
forward_user_id, forward_user_email and forward_user_roles on; every other one is off until turned on: forward_user_id, forward_user_email, forward_username, forward_display_name, forward_user_roles, forward_auth_method, forward_client_ip, forward_session_cookie and pass_credentials (booleans), metadata_headers (metadata keys), custom_headers and custom_cookies (name to value, with variables such as {{.UserEmail}}). pass_credentials passes your app the password, access token or API key ngris checked; off, ngris removes it before your app gets the request, also on an endpoint without sign-in that checks API keys. See What your app receives.password_min_length int
The minimum length of every new password of this endpoint's users (sign-ups, resets, invites, account pages, the passwords you set): between 12 and 64. A value saved below 12 reads as 12.
password_require_uppercase boolean
Require at least one uppercase letter.
password_require_lowercase boolean
Require at least one lowercase letter.
password_require_numbers boolean
Require at least one digit.
password_require_special boolean
Require at least one special character.
Errors
401 Unauthorized
Missing auth.
404 Not Found
Endpoint doesn't exist or doesn't belong to the calling account.
Request
curl "https://api.ngris.com/v1/endpoints/019bb1e4-e785-77d2-9966-c3cff31d0a0e/rbac/registration-policy" \
-H "X-API-KEY: <your_api_key>"
Python
from ngris import Ngris
client = Ngris(api_key="<your_api_key>")
policy = client._get_raw(
"/endpoints/019bb1e4-e785-77d2-9966-c3cff31d0a0e/rbac/registration-policy"
)
print(policy["allow_self_registration"], policy["invite_only"])
Response — 200 OK
{
"allow_self_registration": true,
"invite_only": true,
"auto_approve": false,
"require_email_verification": false,
"default_role_uuid": "019b5fc1-0eb5-7dd8-a0e9-a575428f890d",
"allowed_domains": ["example.com"],
"blocked_domains": [],
"oauth_providers": ["google"],
"signup_form": false,
"signup_sso": true,
"forwarding_config": null,
"password_min_length": 12,
"password_require_uppercase": true,
"password_require_lowercase": true,
"password_require_numbers": true,
"password_require_special": false
}
Was this helpful?