Applications

APIs related to Konnect Developer Portal Applications.

Create Application

Creates a new application for this portal. The application must be assigned to a developer or a team. An application can be registered for various APIs, issuing credentials for API access. If using DCR, an application will be linked to an Identity Provider’s application by its client_id.

post

Path Parameters

portalIdstring(uuid)required

ID of the portal.

Body

application/json

Create an application for a portal.

CreateApplicationRequest

* Additional properties are NOT allowed.
namestringrequired

The name of the application.

<= 255 characters

descriptionstring

A description of the application.

<= 255 characters

labelsobject | null

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"}

dcr_client_idstring

If using a DCR auth strategy, set this property to link the portal application to an existing
client from the DCR provider, instead of having Konnect create a new client.
This allows importing existing clients from an Identity Provider into Konnect, allowing
them to be controlled through the DCR flows in the portal, and use existing client secrets
for API access.
The value must be a valid client ID in the DCR provider associated with the auth strategy.
If it is not valid, application will be created but will not function properly.

<= 255 characters

client_idstring

An identifier to correlate the application with an external system.
Cannot be set when using Dynamic Client Registration.

<= 255 characters

auth_strategy_idstring(uuid)

The ID of the authentication strategy the application will use when making requests to registered APIs.

ownerobjectrequired
* Additional properties are NOT allowed.
Show Child Parameters

Response

application/json

Details about an application in a portal.

GetApplicationResponse

GetApplicationResponse
One Of
idstring(uuid)requiredread-only

Contains a unique identifier used for this resource.

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

created_atstring(date-time)requiredread-only

An ISO-8601 timestamp representation of entity creation date.

Example:2022-11-04T20:10:06.927Z

updated_atstring(date-time)requiredread-only

An ISO-8601 timestamp representation of entity update date.

Example:2022-11-04T20:10:06.927Z

namestringrequired

The name of the application.

descriptionstring | nullrequired

A description of the application.

labelsobject | nullrequired

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"}

client_idstringrequiredread-only

The ID used to linked the portal application to an Identity Provider application.

registration_countnumberrequiredread-only

The number of API registrations that are associated with the application. Registrations of any status are included in the count.

dcr_providerobject | nullrequired

Information about the DCR provider this application uses, if using DCR.

* Additional properties are NOT allowed.
Show Child Parameters
portalobjectrequired

Information about the portal the application is in.

* Additional properties are NOT allowed.
Show Child Parameters
auth_strategyobjectrequired

Client Credential Auth strategy that the application uses.

* Additional properties are NOT allowed.
Show Child Parameters
granted_scopesarray | null[string]required

List of granted scopes for the application. Null if application type does not support returning granted scopes.

ownerobject
* Additional properties are NOT allowed.
Show Child Parameters
post/portals/{portalId}/applications

Body

{ "name": "Portal Application", "description": "A portal application provisioned for a developer by a Portal Admin.", "labels": { "env": "production" }, "auth_strategy_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "owner": { "id": "7f9fd312-a987-4628-b4c5-bb4f4fddd5f7", "type": "developer" } }
 
application/json

Add Developer to Application

Add a developer as an owner of the application.

put

Path Parameters

portalIdstring(uuid)required

ID of the portal.

applicationIdstring(uuid)required

ID of the application.

developerIdstring(uuid)required

ID of the developer.

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

Response

application/json

Details about a developer of an application.

ApplicationDeveloperDetailed

List of developers that have a registered application.

* Additional properties are NOT allowed.
idstring(uuid)requiredread-only

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

emailstring(email)

<= 250 characters

Example:developer@email.com

full_namestring

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

<= 250 characters

Example:API Developer

put/portals/{portalId}/applications/{applicationId}/developers/{developerId}
 
application/json

Remove Developer from Application

Remove a developer from an application. There must be at least one remaining owner.

delete

Path Parameters

portalIdstring(uuid)required

ID of the portal.

applicationIdstring(uuid)required

ID of the application.

developerIdstring(uuid)required

ID of the developer.

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

Response

No Content

delete/portals/{portalId}/applications/{applicationId}/developers/{developerId}
 

Application Registrations

APIs related to Konnect Developer Portal Application Registrations.