Create Team Group Mapping

Creates a new team group mapping for the specified identity provider.
A mapping associates an identity provider group with a Konnect team.

post
https://global.api.konghq.com/v3/identity-providers/{idpId}/team-group-mappings

Path Parameters

idpIdstring(uuid)required

ID of the identity provider.

Example:d32d905a-ed33-46a3-a093-d8f536af9a8a

Body

application/json

Request to create an IDP team group mapping.

team_idstring(uuid)required

The Konnect team ID to associate with the identity provider group.

Example:6801e673-cc10-498a-94cd-4271de07a0d3

groupstringrequired

The identity provider group name. Group names are case sensitive.

Example:Tech Leads

Response

application/json

A single team group mapping.

IdpTeamGroupMapping

A mapping between a Konnect team and an identity provider group.

idstring(uuid)requiredread-only

Contains a unique identifier used for this resource.

Example:5f9fd312-a987-4628-b4c5-bb4f4fddd5f7

team_idstring(uuid)required

The Konnect team ID.

Example:6801e673-cc10-498a-94cd-4271de07a0d3

groupstringrequired

The identity provider group name. Group names are case sensitive.

Example:Tech Leads

created_atstring(date-time)requiredread-only

An ISO-8601 timestamp representation of entity creation date.

Example:2022-11-04T20:10:06.927Z

updated_atstring(date-time)requiredread-only

An ISO-8601 timestamp representation of entity update date.

Example:2022-11-04T20:10:06.927Z

post/identity-providers/{idpId}/team-group-mappings

Body

{ "team_id": "6801e673-cc10-498a-94cd-4271de07a0d3", "group": "Tech Leads" }
 
application/json

Get Team Group Mapping

Returns the team group mapping for the specified ID.

get
https://global.api.konghq.com/v3/identity-providers/{idpId}/team-group-mappings/{id}

Path Parameters

idpIdstring(uuid)required

ID of the identity provider.

Example:d32d905a-ed33-46a3-a093-d8f536af9a8a

idstring(uuid)required

ID of the team group mapping.

Example:7f9fd312-a987-4628-b4c5-bb4f4fddd5f7

Response

application/json

A single team group mapping.

IdpTeamGroupMapping

A mapping between a Konnect team and an identity provider group.

idstring(uuid)requiredread-only

Contains a unique identifier used for this resource.

Example:5f9fd312-a987-4628-b4c5-bb4f4fddd5f7

team_idstring(uuid)required

The Konnect team ID.

Example:6801e673-cc10-498a-94cd-4271de07a0d3

groupstringrequired

The identity provider group name. Group names are case sensitive.

Example:Tech Leads

created_atstring(date-time)requiredread-only

An ISO-8601 timestamp representation of entity creation date.

Example:2022-11-04T20:10:06.927Z

updated_atstring(date-time)requiredread-only

An ISO-8601 timestamp representation of entity update date.

Example:2022-11-04T20:10:06.927Z

get/identity-providers/{idpId}/team-group-mappings/{id}
 
application/json

Delete Team Group Mapping

Deletes a team group mapping by ID.
Returns 204 if the mapping was deleted, or 404 if the mapping was not found.

delete
https://global.api.konghq.com/v3/identity-providers/{idpId}/team-group-mappings/{id}

Path Parameters

idpIdstring(uuid)required

ID of the identity provider.

Example:d32d905a-ed33-46a3-a093-d8f536af9a8a

idstring(uuid)required

ID of the team group mapping.

Example:7f9fd312-a987-4628-b4c5-bb4f4fddd5f7

Response

No Content

delete/identity-providers/{idpId}/team-group-mappings/{id}
 

Roles

Get Predefined Roles

Retrieves the predefined, or system managed, roles.

get
https://global.api.konghq.com/v3/roles

Response

application/json

The predefined, or system managed, roles.

Roles Response

control_planesobject
* Additional properties are NOT allowed.
Show Child Parameters
api_productsobject
* Additional properties are NOT allowed.
Show Child Parameters
portalsobject
* Additional properties are NOT allowed.
Show Child Parameters
application_auth_strategiesobject
* Additional properties are NOT allowed.
Show Child Parameters
dcr_providersobject
* Additional properties are NOT allowed.
Show Child Parameters
audit_logsobject
* Additional properties are NOT allowed.
Show Child Parameters
identityobject
* Additional properties are NOT allowed.
Show Child Parameters
mesh_control_planesobject
* Additional properties are NOT allowed.
Show Child Parameters
dashboardsobject
* Additional properties are NOT allowed.
Show Child Parameters
reportsobject
* Additional properties are NOT allowed.
Show Child Parameters
get/roles
 
application/json