Skip to main content
POST
/
orgs
/
{org_id}
/
identity-providers
/
{provider_id}
/
group-mappings
cURL
curl --request POST \
  --url https://api.timbal.ai/orgs/{org_id}/identity-providers/{provider_id}/group-mappings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "external_group": "<string>",
  "role_id": 123
}
'
{
  "created_at": 123,
  "external_group": "<string>",
  "id": "<string>",
  "provider_id": "<string>",
  "role_id": "<string>",
  "updated_at": 123
}

Authorizations

Authorization
string
header
required

Timbal API key. Obtain your API key from the Timbal platform settings. See Authentication for more information.

Path Parameters

org_id
string
required
provider_id
string
required

Body

application/json

Add an external-group → role mapping to a connection.

external_group
string
required

External group identifier exactly as the IdP emits it.

role_id
integer<int64>
required

Target Timbal role id. Accepts a number or a stringified id.

Response

Mapping created

View of a group→role mapping.

created_at
integer<int64>
required
external_group
string
required
id
string
required
provider_id
string
required
role_id
string
required
updated_at
integer<int64>
required