Portal Developer Applications (2.0.0)

Download OpenAPI specification:Download

N/A (this description is removed during bundling)

applications

The API for Konnect Portal developer applications within a private portal (i.e. requires registration/authentication). When a portal is in public mode, all of the described endpoints will return a 404 error. A public portal means that applications and registrations are not available/needed. In this API's context, "you" and "your" refers to the developer consuming the API.

List Applications

List applications owned by the developer currently logged in.

Authorizations:

portalAccessToken

query Parameters

page[size]	integer Example: page[size]=10 The maximum number of items to include per page. The last page of a collection may include fewer items.
page[number]	integer Example: page[number]=1 Determines which page of the entities to retrieve.
filter[name][eq]	string Example: filter[name][eq]=good service Filter by direct equality comparison of the name property with a supplied value.
filter[name]	string Example: filter[name]=good service Filter by direct equality comparison (short-hand) of the name property with a supplied value.
filter[name][contains]	string Example: filter[name][contains]=good service Filter by contains comparison of the name property with a supplied substring
filter[auth_strategy_id][eq]	string Example: filter[auth_strategy_id][eq]=5be86298-147b-45ab-bfaf-a1bff97dce39 Filter by the id of the auth strategy supported by the application.
filter[auth_strategy_id]	string Example: filter[auth_strategy_id]=5be86298-147b-45ab-bfaf-a1bff97dce39 Filter by the id of the auth strategy supported by the application (short-hand).

Responses

Response samples

200
400
401

Content type

application/json

{"meta": {"page": {"number": 1,
"size": 10,
"total": 100
}
},
"data": [{"id": "5f9fd312-a987-4628-b4c5-bb4f4fddd5f7",
"name": "string",
"reference_id": "string",
"description": "string",
"redirect_uri": "string",
"auth_strategy": {"id": "b9e81174-b5bb-4638-a3c3-8afe61a0abf8",
"name": "name",
"credential_type": "key_auth",
"key_names": ["apikey"
]
},
"scopes": ["string"
],
"created_at": "2022-11-04T20:10:06.927Z",
"updated_at": "2022-11-04T20:10:06.927Z"
}
]
}

Create an Application

Creates a new Application.

Authorizations:

portalAccessToken

Request Body schema: application/json

Create an application

name required	string <= 255 characters The name of the application
reference_id	string (ApplicationReferenceId) <= 255 characters An identifier to correlate the application with an external system. Cannot be set when using Dynamic Client Registration.
redirect_uri	string <uri> URL to redirect to after completing an OIDC auth flow
description	string <= 255 characters A brief description of the application
auth_strategy_id	string or null <uuid> (AuthStrategyId) ID of the auth strategy to use for the application. If null or not included, the default application auth strategy will be used.
scopes	Array of strings (Scopes) Pre-release Endpoint This endpoint is currently in beta and is subject to change. The granted scopes for the application. Will only be included if supported by the application's auth strategy.

Responses

Request samples

Payload

Content type

application/json

{"name": "string",
"reference_id": "string",
"redirect_uri": "http://example.com",
"description": "string",
"auth_strategy_id": "e5dd1b68-9505-4524-a9e0-e088d563e7e6",
"scopes": ["string"
]
}

Response samples

Content type

application/json

{"id": "5f9fd312-a987-4628-b4c5-bb4f4fddd5f7",
"name": "string",
"reference_id": "string",
"description": "string",
"redirect_uri": "string",
"credentials": {"client_id": "string",
"client_secret": "string"
},
"auth_strategy": {"id": "b9e81174-b5bb-4638-a3c3-8afe61a0abf8",
"name": "name",
"credential_type": "key_auth",
"key_names": ["apikey"
]
},
"scopes": ["string"
],
"created_at": "2022-11-04T20:10:06.927Z",
"updated_at": "2022-11-04T20:10:06.927Z"
}

Get an Application

Gets the details for an existing application. You need only supply the unique application identifier that was returned upon application creation or by the list-applications endpoint.

Authorizations:

portalAccessToken

path Parameters

applicationId

required

string <uuid>

Id of the targeted application

Responses

Response samples

200
400
401
404

Content type

application/json

{"id": "5f9fd312-a987-4628-b4c5-bb4f4fddd5f7",
"name": "string",
"reference_id": "string",
"description": "string",
"redirect_uri": "string",
"auth_strategy": {"id": "b9e81174-b5bb-4638-a3c3-8afe61a0abf8",
"name": "name",
"credential_type": "key_auth",
"key_names": ["apikey"
]
},
"scopes": ["string"
],
"created_at": "2022-11-04T20:10:06.927Z",
"updated_at": "2022-11-04T20:10:06.927Z"
}

Delete Application

Deletes an application and all of its associated entities (registrations).

Authorizations:

portalAccessToken

path Parameters

applicationId

required

string <uuid>

Id of the targeted application

Responses

Response samples

400
401
404
429

Content type

application/problem+json

{"status": 0,
"title": "string",
"type": "string",
"instance": "string",
"detail": "string",
"invalid_parameters": [{"field": "name",
"rule": "required",
"source": "body",
"reason": "is a required field"
}
]
}

Update Application

Updates an application, replacing specified properties with any new values supplied in the request body.

Authorizations:

portalAccessToken

path Parameters

applicationId

required

string <uuid>

Id of the targeted application

Request Body schema: application/json

Update an application

name	string <= 255 characters The name of the application
reference_id	string (ApplicationReferenceId) <= 255 characters An identifier to correlate the application with an external system. Cannot be set when using Dynamic Client Registration.
redirect_uri	string <uri> URL to redirect to after completing an OIDC auth flow
description	string <= 255 characters A brief description of the application
scopes	Array of strings (Scopes) Pre-release Endpoint This endpoint is currently in beta and is subject to change. The granted scopes for the application. Will only be included if supported by the application's auth strategy.

Responses

Request samples

Payload

Content type

application/json

{"name": "string",
"reference_id": "string",
"redirect_uri": "http://example.com",
"description": "string",
"scopes": ["string"
]
}

Response samples

200
400
401
404
409

Content type

application/json

{"id": "5f9fd312-a987-4628-b4c5-bb4f4fddd5f7",
"name": "string",
"reference_id": "string",
"description": "A brief description of the application",
"redirect_uri": "https://example.com/callback",
"auth_strategy": {"id": "b9e81174-b5bb-4638-a3c3-8afe61a0abf8",
"name": "name",
"credential_type": "key_auth",
"key_names": ["apikey"
]
},
"scopes": ["string"
],
"created_at": "2022-11-04T20:10:06.927Z",
"updated_at": "2022-11-04T20:10:06.927Z"
}

Get the granted scopes

Retrieves the granted scopes of a specified application and product version directly from the IDP. Scopes shared between product versions will be returned, even if not currently registered for given product version. Will return 422 if this feature is not supported by the application.

Authorizations:

portalAccessToken

path Parameters

applicationId required	string <uuid> Id of the targeted application
productVersionId required	string <uuid> Contains a unique identifier used by the Portal API for this resource.

Responses

Response samples

200
401
404
422

Content type

application/json

{"scopes": ["openid"
]
}

List the available auth strategies

Retrieve the available Auth Strategies on this portal. An Auth Strategy is a set of plugin configurations that represent how the gateway will perform authentication and authorization for a Product Version. It may reference to Key-Auth or an OIDC configuration (with or without DCR).

Authorizations:

portalAccessToken

query Parameters

page[size]	integer Example: page[size]=10 The maximum number of items to include per page. The last page of a collection may include fewer items.
page[number]	integer Example: page[number]=1 Determines which page of the entities to retrieve.
filter[name][eq]	string Example: filter[name][eq]=good service Filter by direct equality comparison of the name property with a supplied value.
filter[name]	string Example: filter[name]=good service Filter by direct equality comparison (short-hand) of the name property with a supplied value.
filter[name][contains]	string Example: filter[name][contains]=good service Filter by contains comparison of the name property with a supplied substring
filter[credential_type][eq]	string Enum: "client_credentials" "self_managed_client_credentials" "key_auth" Example: filter[credential_type][eq]=key_auth Filter by direct equality comparison of the credential_type with a supplied value.

Responses

Response samples

200
400
401

Content type

application/json

{"meta": {"page": {"number": 1,
"size": 10,
"total": 100
}
},
"data": [{"id": "b9e81174-b5bb-4638-a3c3-8afe61a0abf8",
"name": "name",
"credential_type": "key_auth",
"key_names": ["apikey"
]
}
]
}

credentials

The API for Konnect Portal developer credentials within a private portal (i.e. requires registration/authentication).

Refresh Client Secret

Resets the client secret for an application.

Authorizations:

portalAccessToken

path Parameters

applicationId

required

string <uuid>

Id of the targeted application

Responses

Response samples

201
400
401
404

Content type

application/json

{"client_id": "string",
"client_secret": "string"
}

List credentials

Lists the credentials for an application they own.

Authorizations:

portalAccessToken

path Parameters

applicationId

required

string <uuid>

Id of the targeted application

query Parameters

page[size]	integer Example: page[size]=10 The maximum number of items to include per page. The last page of a collection may include fewer items.
page[number]	integer Example: page[number]=1 Determines which page of the entities to retrieve.

Responses

Response samples

200
400
404
409

Content type

application/json

{"meta": {"page": {"number": 1,
"size": 10,
"total": 100
}
},
"data": [{"id": "5f9fd312-a987-4628-b4c5-bb4f4fddd5f7",
"display_name": "string"
}
]
}

Create Credential for Application

Allows a developer to create a credential for an application they own.

Authorizations:

portalAccessToken

path Parameters

applicationId

required

string <uuid>

Id of the targeted application

Request Body schema: application/json

Create a credential

display_name

string <= 255 characters

Responses

Request samples

Payload

Content type

application/json

{"display_name": "string"
}

Response samples

201
400
401
403
404

Content type

application/json

{"credential": "string",
"id": "5f9fd312-a987-4628-b4c5-bb4f4fddd5f7",
"display_name": "string"
}

Update Credential

Updates a credential for an application owned by the current logged in developer.

Authorizations:

portalAccessToken

path Parameters

applicationId required	string <uuid> Id of the targeted application
credentialId required	string <uuid> Id of the targeted credential

Request Body schema: application/json

Update a credential

display_name

required

string <= 255 characters

Responses

Request samples

Payload

Content type

application/json

{"display_name": "string"
}

Response samples

400
401
404

Content type

application/problem+json

{"status": 0,
"title": "string",
"type": "string",
"instance": "string",
"detail": "string",
"invalid_parameters": [{"field": "name",
"rule": "required",
"source": "body",
"reason": "is a required field"
}
]
}

Delete Credential

Deletes a credential for an application they own.

Authorizations:

portalAccessToken

path Parameters

applicationId required	string <uuid> Id of the targeted application
credentialId required	string <uuid> Id of the targeted credential

Responses

Response samples

400
401
404
409

Content type

application/problem+json

{"status": 0,
"title": "string",
"type": "string",
"instance": "string",
"detail": "string",
"invalid_parameters": [{"field": "name",
"rule": "required",
"source": "body",
"reason": "is a required field"
}
]
}