Create a group→role mapping

Maps a raw IdP group to an ANKASecure role for this tenant (the deny-by-default admission input). 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 — a PLATFORM_* composite, for instance — 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.tenant.idp.mapping.manage.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required
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