Update Team Mappings

Updates the IdP group to Konnect team mapping.

put
https://global.api.konghq.com/v3/identity-provider/team-mappings

Body

application/json

The request schema for updating IdP team mappings.

mappingsarray[object]

The mappings object.

Show Child Parameters

Response

application/json

A paginated list response for a collection of team mappings.

Team Mapping Collection Response

dataarray[object]

A team assignment is a mapping of an IdP group to a Konnect Team.

Example:{"group":"Service Developers","team_ids":["6801e673-cc10-498a-94cd-4271de07a0d3"]}

Show Child Parameters
put/identity-provider/team-mappings

Body

{ "mappings": [ { "group": "Service Developers", "team_ids": [ "af91db4c-6e51-403e-a2bf-33d27ae50c0a" ] } ] }
 
application/json

Get a Team Mapping

Fetch the IdP group to Konnect team mapping.

get
https://global.api.konghq.com/v3/identity-provider/team-mappings

Query Parameters

page[size]integer

The maximum number of items to include per page. The last page of a collection may include fewer items.

Example:10

page[number]integer

Determines which page of the entities to retrieve.

Example:1

Response

application/json

A paginated list response for a collection of team mappings.

Team Mapping Response

metaobject

Contains pagination data.

Show Child Parameters
dataarray[object]
Show Child Parameters
get/identity-provider/team-mappings
 
application/json

Get a Team Group Mappings

Retrieves the mappings between Konnect Teams and Identity Provider Groups.
Returns a 400 error if an Identity Provider has not yet been configured.

get
https://global.api.konghq.com/v3/identity-provider/team-group-mappings

Query Parameters

page[size]integer

The maximum number of items to include per page. The last page of a collection may include fewer items.

Example:10

page[number]integer

Determines which page of the entities to retrieve.

Example:1

Response

application/json

A paginated collection of mappings grouped by team_id.

Team Group Mapping Collection Response

metaobject

returns the pagination information

Show Child Parameters
dataarray[object]

A map of Konnect Team to IdP groups.

Example:{"team_id":"6801e673-cc10-498a-94cd-4271de07a0d3","groups":["Tech Leads","API Engineers"]}

Show Child Parameters
get/identity-provider/team-group-mappings
 
application/json

Patch Mappings by Team ID

Allows partial updates to the mappings between Konnect Teams and Identity Provider Groups.
The request body must be keyed on team ID. For a given team ID, the given group list is a
complete replacement. To remove all mappings for a given team, provide an empty group list.

Returns a 400 error if an Identity Provider has not yet been configured, or if a team ID in
the request body is not found or is not a UUID.

patch
https://global.api.konghq.com/v3/identity-provider/team-group-mappings

Body

application/json

The request schema for a partial update of mappings from Konnect Teams to IdP Groups.

dataarray[object]

The IdP groups to map to the given team.

Show Child Parameters

Response

application/json

A paginated collection of mappings grouped by team_id.

Team Group Mapping Collection Response

metaobject

returns the pagination information

Show Child Parameters
dataarray[object]

A map of Konnect Team to IdP groups.

Example:{"team_id":"6801e673-cc10-498a-94cd-4271de07a0d3","groups":["Tech Leads","API Engineers"]}

Show Child Parameters
patch/identity-provider/team-group-mappings

Body

{ "data": [ { "team_id": "af91db4c-6e51-403e-a2bf-33d27ae50c0a", "groups": [ "Service Developers" ] } ] }
 
application/json

Invites