sso

Create a new SSO group mapping

post/admin/v1/organizations/{org_slug}/sso-group-mappings

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /admin/v1/organizations/{org_slug}/sso-group-mappings
  • Auth: HTTP bearer

Path parameters

org_slugstring required

Organization slug

Request body

idp_groupstring required

The IdP group name exactly as it appears in the groups claim

priorityinteger

Priority for role precedence (higher = wins when multiple mappings target same team) Defaults to 0 if not specified.

rolestring nullable

Role to assign (within the team if team_id is set, otherwise org-level role)

sso_connection_namestring

Which SSO connection this mapping applies to (defaults to 'default')

team_idstring uuid nullable

Team to add users to when they have this IdP group (optional)

Response

SSO group mapping created

created_atstring date-time required

When this mapping was created

idstring uuid required

Unique identifier for this mapping

idp_groupstring required

The IdP group name exactly as it appears in the groups claim

org_idstring uuid required

Organization this mapping belongs to (mappings are org-scoped)

priorityinteger required

Priority for role precedence (higher = wins when multiple mappings target same team)

rolestring nullable

Role to assign (within the team if team_id is set, otherwise org-level role)

sso_connection_namestring required

Which SSO connection this mapping applies to (from config, defaults to 'default')

team_idstring uuid nullable

Team to add users to when they have this IdP group (optional)

updated_atstring date-time required

When this mapping was last updated

Changes

No recorded changes to this operation across all 1 revision of this API.