Create an email/domain admission rule for the deployment-default provider

Maps a federated email address or normalized domain to an ANKASecure role at the platform (ROOT) scope — the email/domain half of the deny-by-default admission input. A DOMAIN rule may not grant a platform-scope / wildcard role (422); an EMAIL rule is uncapped by that privilege ceiling. Independently of that ceiling, and on BOTH rule types, the admitted role is checked at declaration time so the rule cannot be created in a state the federated login path is unable to consume: an unknown role, or a custom role owned by another tenant, is refused 404 (both causes are collapsed into one oracle-safe body); a service-to-service-only role is refused 400; and a role that is not assignable inside a tenant of this type is refused 422 federated-role-not-assignable. Cross-surface divergence, deliberate: the SAME (role, tenant type) matrix answers 400 invalid-input on assignUserRoles and 422 here. The user-assignment surface rejects a malformed assignment request, whereas this surface accepts a well-formed declaration whose semantics cannot be satisfied — which is what 422 means. Required scope: admin.platform.idp.manage.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Create an email/domain admission rule mapping a federated email or domain to an ANKASecure role for this tenant.

uuid
required

Id of the identity provider this rule applies to.

string
enum
required

Match axis: EMAIL (full address) or DOMAIN (normalized domain).

Allowed:
string
required
length between 0 and 320
\A[^*\x00-\x1F\x7F]+\z

The email address (ruleType=EMAIL) or domain (ruleType=DOMAIN) to match.

string
required
length between 0 and 128

ANKASecure system or tenant-custom role name this rule grants on a match.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json