Get Registration Policy

GET /v1/endpoints/{uuid}/rbac/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 — when false, 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. With invite_only: true it 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?
Was this helpful?