List Team Group Mappings
Returns a paginated list of team group mappings for the specified identity provider.
Mappings define the relationship between identity provider groups and Konnect teams.
Query Parameters
The maximum number of items to include per page. The last page of a collection may include fewer items.
Example:10
Request the next page of data, starting with the item after this parameter.
Example:ewogICJpZCI6ICJoZWxsbyB3b3JsZCIKfQ
Request the next page of data, starting with the item before this parameter.
Example:ewogICJpZCI6ICJoZWxsbyB3b3JsZCIKfQ
Filter mappings by team ID or group name.
Show Child Parameters
Path Parameters
ID of the identity provider.
Example:d32d905a-ed33-46a3-a093-d8f536af9a8a
Response
application/json
Response
A paginated collection of IDP team group mappings.
Pagination metadata.
Show Child Parameters
A mapping between a Konnect team and an identity provider group.
Show Child Parameters
Authentication
Path Parameters
Query Parameters
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.
Path Parameters
ID of the identity provider.
Example:d32d905a-ed33-46a3-a093-d8f536af9a8a
Body
application/json
Body
Request to create an IDP team group mapping.
The Konnect team ID to associate with the identity provider group.
Example:6801e673-cc10-498a-94cd-4271de07a0d3
The identity provider group name. Group names are case sensitive.
Example:Tech Leads
Response
application/json
Response
A single team group mapping.
IdpTeamGroupMapping
A mapping between a Konnect team and an identity provider group.
Contains a unique identifier used for this resource.
Example:5f9fd312-a987-4628-b4c5-bb4f4fddd5f7
The Konnect team ID.
Example:6801e673-cc10-498a-94cd-4271de07a0d3
The identity provider group name. Group names are case sensitive.
Example:Tech Leads
An ISO-8601 timestamp representation of entity creation date.
Example:2022-11-04T20:10:06.927Z
An ISO-8601 timestamp representation of entity update date.
Example:2022-11-04T20:10:06.927Z
Authentication
Path Parameters
Body
Get Team Group Mapping
Returns the team group mapping for the specified ID.
Path Parameters
ID of the identity provider.
Example:d32d905a-ed33-46a3-a093-d8f536af9a8a
ID of the team group mapping.
Example:7f9fd312-a987-4628-b4c5-bb4f4fddd5f7
Response
application/json
Response
A single team group mapping.
IdpTeamGroupMapping
A mapping between a Konnect team and an identity provider group.
Contains a unique identifier used for this resource.
Example:5f9fd312-a987-4628-b4c5-bb4f4fddd5f7
The Konnect team ID.
Example:6801e673-cc10-498a-94cd-4271de07a0d3
The identity provider group name. Group names are case sensitive.
Example:Tech Leads
An ISO-8601 timestamp representation of entity creation date.
Example:2022-11-04T20:10:06.927Z
An ISO-8601 timestamp representation of entity update date.
Example:2022-11-04T20:10:06.927Z
Authentication
Path Parameters
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.
Path Parameters
ID of the identity provider.
Example:d32d905a-ed33-46a3-a093-d8f536af9a8a
ID of the team group mapping.
Example:7f9fd312-a987-4628-b4c5-bb4f4fddd5f7
Response
Response
No Content