Create Team

Creates a team in the Konnect Organization.

post
https://global.api.konghq.com/v2/teams

Body

application/json

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.

namestringrequired

A name for the team being created.

Match pattern:^[\w \W]+$

Example:IDM - Developers

descriptionstring

The description of the new team.

<= 250 characters

Example:The Identity Management (IDM) team.

Response

application/json

A response including a single team.

Team

The team object contains information about a group of users.

idstring(uuid)read-only

The team ID.

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

namestring

The name of the team.

Match pattern:^[\w \W]+$

<= 250 characters

Example:IDM - Developers

descriptionstring

The team description in Konnect.

<= 250 characters

Example:The developers for the IDM API.

system_teambooleanread-only

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

created_atstring(date-time)read-only

A Unix timestamp representation of team creation.

Example:1992-02-07T17:46:57.52Z

updated_atstring(date-time)read-only

A Unix timestamp representation of the most recent change to the team object in Konnect.

Example:2022-02-07T17:00:00.52Z

post/teams

Body

{ "name": "IDM - Developers", "description": "The Identity Management (IDM) team." }
 
application/json

Get a Team

Returns information about a team from a given team ID.

get
https://global.api.konghq.com/v2/teams/{teamId}

Path Parameters

teamIdstring(uuid)required

The team ID

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

Response

application/json

A response including a single team.

Team

The team object contains information about a group of users.

idstring(uuid)read-only

The team ID.

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

namestring

The name of the team.

Match pattern:^[\w \W]+$

<= 250 characters

Example:IDM - Developers

descriptionstring

The team description in Konnect.

<= 250 characters

Example:The developers for the IDM API.

system_teambooleanread-only

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

created_atstring(date-time)read-only

A Unix timestamp representation of team creation.

Example:1992-02-07T17:46:57.52Z

updated_atstring(date-time)read-only

A Unix timestamp representation of the most recent change to the team object in Konnect.

Example:2022-02-07T17:00:00.52Z

get/teams/{teamId}
 
application/json

Update Team

Updates an individual team.

patch
https://global.api.konghq.com/v2/teams/{teamId}

Path Parameters

teamIdstring(uuid)required

The team ID

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

Body

application/json

The request schema for the update team request.

namestring

The name of the team.

Match pattern:^[\w \W]+$

Example:IDM - Developers

descriptionstring

The description of the team.

<= 250 characters

Example:The Identity Management (IDM) API team.

Response

application/json

A response including a single team.

Team

The team object contains information about a group of users.

idstring(uuid)read-only

The team ID.

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

namestring

The name of the team.

Match pattern:^[\w \W]+$

<= 250 characters

Example:IDM - Developers

descriptionstring

The team description in Konnect.

<= 250 characters

Example:The developers for the IDM API.

system_teambooleanread-only

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

created_atstring(date-time)read-only

A Unix timestamp representation of team creation.

Example:1992-02-07T17:46:57.52Z

updated_atstring(date-time)read-only

A Unix timestamp representation of the most recent change to the team object in Konnect.

Example:2022-02-07T17:00:00.52Z

patch/teams/{teamId}

Body

{ "name": "IDM - Developers", "description": "The Identity Management (IDM) API team." }
 
application/json

Delete Team

Deletes an individual team. Returns 404 if the team is not found.

delete
https://global.api.konghq.com/v2/teams/{teamId}

Path Parameters

teamIdstring(uuid)required

The team ID

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

Response

No Content

delete/teams/{teamId}
 

Users