Sign in

v51

latestOpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-08-058638763.1 MB
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/v3/portals/{portalId}/applications

Path parameters

portalIdstring uuid required
Example:f32d905a-ed33-46a3-a093-d8f536af9a8a

The Portal identifier

Request body

namestring required

The name of the application.

descriptionstring

A description of the application.

labelsLabelsUpdate nullable

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 "_".

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 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. For some DCR providers, if the client ID is invalid, the application may still be created but will not function properly.

Note: For AzureAD auth strategies, the client ID must resolve to an accessible Microsoft Entra application using the configured DCR provider credentials. Otherwise, application creation fails.

client_idstring

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

auth_strategy_idstring uuid

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

Example request

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

Response

Details about an application in a portal.

idstring uuid required

Contains a unique identifier used for this resource.

created_atstring date-time required

An ISO-8601 timestamp representation of entity creation date.

updated_atstring date-time required

An ISO-8601 timestamp representation of entity update date.

namestring required

The name of the application.

descriptionstring nullable required

A description of the application.

labelsLabelsUpdate nullable required

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 "_".

client_idstring

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

registration_countnumber required

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

granted_scopesstring[] nullable

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

Example response

{
  "id": "b15e2460-ba40-431d-9df0-4957fcffacda",
  "labels": {
    "env": "test"
  },
  "name": "App 1",
  "description": "An easy to manage app in a Konnect developer portal",
  "registration_count": 4,
  "portal": {
    "id": "95606071-49c7-4c2e-ae49-8a86d72a8110"
  },
  "auth_strategy": {
    "id": "45606071-49c7-4c2e-ae49-8a86d72a8110",
    "name": "API Key",
    "credential_type": "key_auth",
    "key_names": [
      "apikey"
    ]
  },
  "created_at": "2022-12-22T19:09:30.712Z",
  "updated_at": "2022-12-22T19:09:30.712Z",
  "owner": {
    "id": "8cd9feff-b4da-4a9f-ba49-cbe83c75ff22",
    "type": "developer"
  }
}