Get Team

Get an individual team.

get

Path Parameters

teamIdstring(uuid)required

ID of the team.

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

portalIdstring(uuid)required

ID of the portal.

Response

application/json

Details about a team of developers in a portal.

PortalTeamResponse

Details about a developer team.

idstring(uuid)read-only

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

namestring

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

<= 250 characters

Example:IDM - Developers

descriptionstring

<= 250 characters

Example:The developers for the IDM API.

created_atstring(date-time)read-only

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

updated_atstring(date-time)read-only

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

can_own_applicationsboolean

Whether the team is allowed to own applications.

Example:false

get/portals/{portalId}/teams/{teamId}
 
application/json

Update Team

Updates an individual developer team for a portal.

patch

Path Parameters

teamIdstring(uuid)required

ID of the team.

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

portalIdstring(uuid)required

ID of the portal.

Body

application/json

Update a team in a portal.

PortalUpdateTeamRequest

Properties to update on a team.

namestring

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

Example:IDM - Developers

descriptionstring

<= 250 characters

Example:The Identity Management (IDM) API team.

can_own_applicationsboolean

Whether the team is allowed to own applications.

Example:true

Response

application/json

Details about a team of developers in a portal.

PortalTeamResponse

Details about a developer team.

idstring(uuid)read-only

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

namestring

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

<= 250 characters

Example:IDM - Developers

descriptionstring

<= 250 characters

Example:The developers for the IDM API.

created_atstring(date-time)read-only

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

updated_atstring(date-time)read-only

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

can_own_applicationsboolean

Whether the team is allowed to own applications.

Example:false

patch/portals/{portalId}/teams/{teamId}

Body

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

Delete Team

Deletes a developer team from a portal. Deleting a team also deletes its assigned roles. Members of the team are not deleted, but they will lose any access provided through the team.

delete

Path Parameters

teamIdstring(uuid)required

ID of the team.

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

portalIdstring(uuid)required

ID of the portal.

Response

No Content

delete/portals/{portalId}/teams/{teamId}
 

Portal Team Membership

APIs related to Konnect Developer Portal developer team membership.

List Team Developers

List a team’s developers.

get

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

filterobject

Filter developers returned in the response.

Show Child Parameters

Path Parameters

portalIdstring(uuid)required

ID of the portal.

teamIdstring(uuid)required

ID of the team.

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

Response

application/json

A paginated list of basic developer information.

ListBasicDevelopersResponse

A paginated list of basic information about a set of developers.

metaobject

returns the pagination information

Show Child Parameters
dataarray[object]

Basic information about a developer.

Example:{"id":"7f9fd312-a987-4628-b4c5-bb4f4fddd5f7","email":"user@email.com","full_name":"API Developer","active":true,"created_at":"2022-02-07T17:46:57.52Z","updated_at":"2022-10-08T17:00:00.52Z"}

Show Child Parameters
get/portals/{portalId}/teams/{teamId}/developers
 
application/json