Create Team
Creates a team in the Konnect Organization.
Body
application/json
Body
The request schema for the create team request.
If you pass the same name and description of an existing team in the request, a team with the same name and description will be created. The two teams will have different team_id values to differentiate them.
A name for the team being created.
Match pattern:^[\w \W]+$
Example:IDM - Developers
The description of the new team.
<= 250 characters
Example:The Identity Management (IDM) team.
Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
Keys must be of length 1-63 characters, and cannot start with “kong”, “konnect”, “mesh”, “kic”, or “_”.
Example:{"env":"test"}
Response
application/json
Response
A response including a single team.
Team
The team object contains information about a group of users.
The team ID.
Example:7f9fd312-a987-4628-b4c5-bb4f4fddd5f7
The name of the team.
Match pattern:^[\w \W]+$
<= 250 characters
Example:IDM - Developers
The team description in Konnect.
<= 250 characters
Example:The developers for the IDM API.
Returns True if a user belongs to a system_team. System teams are teams that can manage Konnect objects, like “Organization Admin”, or “Service”
Default:false
Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
Keys must be of length 1-63 characters, and cannot start with “kong”, “konnect”, “mesh”, “kic”, or “_”.
Example:{"env":"test"}
A Unix timestamp representation of team creation.
Example:1992-02-07T17:46:57.52Z
A Unix timestamp representation of the most recent change to the team object in Konnect.
Example:2022-02-07T17:00:00.52Z
Authentication
Body
Get a Team
Returns information about a team from a given team ID.
Path Parameters
The team ID
Example:d32d905a-ed33-46a3-a093-d8f536af9a8a
Response
application/json
Response
A response including a single team.
Team
The team object contains information about a group of users.
The team ID.
Example:7f9fd312-a987-4628-b4c5-bb4f4fddd5f7
The name of the team.
Match pattern:^[\w \W]+$
<= 250 characters
Example:IDM - Developers
The team description in Konnect.
<= 250 characters
Example:The developers for the IDM API.
Returns True if a user belongs to a system_team. System teams are teams that can manage Konnect objects, like “Organization Admin”, or “Service”
Default:false
Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
Keys must be of length 1-63 characters, and cannot start with “kong”, “konnect”, “mesh”, “kic”, or “_”.
Example:{"env":"test"}
A Unix timestamp representation of team creation.
Example:1992-02-07T17:46:57.52Z
A Unix timestamp representation of the most recent change to the team object in Konnect.
Example:2022-02-07T17:00:00.52Z
Authentication
Path Parameters
Update Team
Updates an individual team.
Path Parameters
The team ID
Example:d32d905a-ed33-46a3-a093-d8f536af9a8a
Body
application/json
Body
The request schema for the update team request.
The name of the team.
Match pattern:^[\w \W]+$
Example:IDM - Developers
The description of the team.
<= 250 characters
Example:The Identity Management (IDM) API team.
Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
Labels are intended to store INTERNAL metadata.
Keys must be of length 1-63 characters, and cannot start with “kong”, “konnect”, “mesh”, “kic”, or “_”.
Example:{"env":"test"}
Response
application/json
Response
A response including a single team.
Team
The team object contains information about a group of users.
The team ID.
Example:7f9fd312-a987-4628-b4c5-bb4f4fddd5f7
The name of the team.
Match pattern:^[\w \W]+$
<= 250 characters
Example:IDM - Developers
The team description in Konnect.
<= 250 characters
Example:The developers for the IDM API.
Returns True if a user belongs to a system_team. System teams are teams that can manage Konnect objects, like “Organization Admin”, or “Service”
Default:false
Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
Keys must be of length 1-63 characters, and cannot start with “kong”, “konnect”, “mesh”, “kic”, or “_”.
Example:{"env":"test"}
A Unix timestamp representation of team creation.
Example:1992-02-07T17:46:57.52Z
A Unix timestamp representation of the most recent change to the team object in Konnect.
Example:2022-02-07T17:00:00.52Z
Authentication
Path Parameters
Body
Delete Team
Deletes an individual team. Returns 404 if the team is not found.
Path Parameters
The team ID
Example:d32d905a-ed33-46a3-a093-d8f536af9a8a
Response
Response
No Content