Create a group→role mapping for the deployment-default provider

Maps a raw IdP group to an ANKASecure role at the platform (ROOT) scope — the deny-by-default admission input. Unlike the tenant plane, the deployment plane uses the single admin.platform.idp.manage scope (no separate mapping scope). The mapped role is checked at declaration time so the mapping 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

Map a raw IdP group string to an ANKASecure role for this tenant.

uuid
required

Id of the identity provider this mapping applies to.

string
required
length between 0 and 512

Raw IdP-named group string (displayName or object id).

string
required
length between 0 and 128

ANKASecure system or tenant-custom role name this group grants.

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