List Team Group Mappings
Lists mappings between Konnect portal teams and Identity Provider (IdP) groups. Returns a 400 error if an IdP has not yet been configured.
Query Parameters
The maximum number of items to include per page. The last page of a collection may include fewer items.
Example:10
Determines which page of the entities to retrieve.
Example:1
Path Parameters
ID of the portal.
Response
application/json
Response
A paginated collection of mappings grouped by team ID.
PortalTeamGroupMappingResponse
A paginated list of portal team group mappings.
returns the pagination information
Show Child Parameters
A map of portal teams to Identity Provider groups.
Example:{"team_id":"6801e673-cc10-498a-94cd-4271de07a0d3","groups":["Tech Leads","API Engineers"]}
Show Child Parameters
Authentication
Path Parameters
Query Parameters
Update Team Group Mappings
Allows partial updates to the mappings between Konnect portal teams and Identity Provider (IdP) 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 IdP has not yet been configured, or if a team ID in the request body is not found or is not a UUID.
Path Parameters
ID of the portal.
Body
application/json
Body
PortalTeamGroupMappingsUpdateRequest
A set of mappings to update from a team to their groups.
The IdP groups to map to the given team.
Show Child Parameters
Response
application/json
Response
A paginated collection of mappings grouped by team ID.
PortalTeamGroupMappingResponse
A paginated list of portal team group mappings.
returns the pagination information
Show Child Parameters
A map of portal teams to Identity Provider groups.
Example:{"team_id":"6801e673-cc10-498a-94cd-4271de07a0d3","groups":["Tech Leads","API Engineers"]}
Show Child Parameters
Authentication
Path Parameters
Body
List Identity Providers
Retrieves the identity providers available within the portal. This operation provides information about
various identity providers for SAML or OIDC authentication integrations.
Query Parameters
Filter identity providers returned in the response.
Show Child Parameters
Path Parameters
ID of the portal.
Response
application/json
Response
A collection of identity providers. This response contains a collection of identity providers, which may include both OIDC and SAML identity providers.
Identity Provider Collection Response
The identity provider that contains configuration data for authentication integration.
Contains a unique identifier used for this resource.
Example:5f9fd312-a987-4628-b4c5-bb4f4fddd5f7
Specifies the type of identity provider.
Allowed values:oidcsaml
Example:oidc
Indicates whether the identity provider is enabled.
Only one identity provider can be active at a time, such as SAML or OIDC.
Default:false
Example:true
One OfThe identity provider that contains configuration data for the OIDC authentication integration.
Show Child Parameters
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
Query Parameters
Create Identity Provider
Creates a new identity provider. This operation allows the creation of a new identity provider for
authentication purposes.
Path Parameters
ID of the portal.
Body
application/json
Body
An object representing the configuration for creating a new identity provider. This configuration may pertain to either an OIDC or a SAML identity provider.
Identity Provider
The identity provider that contains configuration data for creating an authentication integration.
Indicates whether the identity provider is enabled.
Only one identity provider can be active at a time, such as SAML or OIDC.
Default:false
Example:true
Specifies the type of identity provider.
Allowed values:oidcsaml
Example:oidc
One OfThe identity provider that contains configuration data for the OIDC authentication integration.
Show Child Parameters
Response
application/json
Response
An identity provider configuration. This response represents the configuration of a specific identity provider, which can be either OIDC or SAML.
Identity Provider
The identity provider that contains configuration data for authentication integration.
Contains a unique identifier used for this resource.
Example:5f9fd312-a987-4628-b4c5-bb4f4fddd5f7
Specifies the type of identity provider.
Allowed values:oidcsaml
Example:oidc
Indicates whether the identity provider is enabled.
Only one identity provider can be active at a time, such as SAML or OIDC.
Default:false
Example:true
One OfThe identity provider that contains configuration data for the OIDC authentication integration.
Show Child Parameters
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 Identity Provider
Retrieves the configuration of a single identity provider. This operation returns information about a
specific identity provider’s settings and authentication integration details.
Path Parameters
ID of the portal.
ID of the identity provider.
Example:d32d905a-ed33-46a3-a093-d8f536af9a8a
Response
application/json
Response
An identity provider configuration. This response represents the configuration of a specific identity provider, which can be either OIDC or SAML.
Identity Provider
The identity provider that contains configuration data for authentication integration.
Contains a unique identifier used for this resource.
Example:5f9fd312-a987-4628-b4c5-bb4f4fddd5f7
Specifies the type of identity provider.
Allowed values:oidcsaml
Example:oidc
Indicates whether the identity provider is enabled.
Only one identity provider can be active at a time, such as SAML or OIDC.
Default:false
Example:true
One OfThe identity provider that contains configuration data for the OIDC authentication integration.
Show Child Parameters
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