Skip to main content
POST
Map an IdP group to a role

Authorizations

Authorization
string
header
required

API key (dh_live_...) or Auth0 JWT token

Headers

Idempotency-Key
string

Replays the stored response for 24h when the same key is sent again (1–255 visible ASCII)

X-DevHelm-Client
string

Calling surface and version, e.g. cli/1.4.0 or sdk-js/2.0.0

Path Parameters

orgId
integer<int32>
required

Body

application/json

Map an identity provider group to an organization role

idpGroup
string
required

Group name or ID as the identity provider sends it (max 256)

Maximum string length: 256
role
enum<string>
required

Role for members of this group; any role except OWNER

Available options:
OWNER,
ADMIN,
MEMBER,
INCIDENT_AUTHOR,
VIEWER

Response

Created

data
object
required

An identity provider group that grants an organization role at SSO sign-in