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.

post
/api/v2/applications/{applicationId}/refresh-token

Path Parameters

applicationIdstring(uuid)required

Id of the targeted application

Response

application/json

Refresh token response

Refresh token response

Refresh token response

* Additional properties are NOT allowed.
client_idstringrequired
client_secretstringrequired
application/json

List credentials

Lists the credentials for an application they own.

get
/api/v2/applications/{applicationId}/credentials

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

Path Parameters

applicationIdstring(uuid)required

Id of the targeted application

Response

application/json

List credentials response

ListCredentialsResponse

* Additional properties are NOT allowed.
metaobjectrequired

returns the pagination information

Show Child Parameters
dataOne Of
array[object]required
ApiKeyCredentialListItemobject

API key credential returned when listing credentials.

* Additional properties are NOT allowed.
Show Child Parameters
application/json

Create Credential for Application

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

post
/api/v2/applications/{applicationId}/credentials

Path Parameters

applicationIdstring(uuid)required

Id of the targeted application

Body

application/json

Create a credential

CreateCredentialRequest

* Additional properties are NOT allowed.
display_namestring

<= 255 characters

Response

application/json

Credential Creation success

CredentialCreationResponse

CredentialCreationResponseobject
One Of
typestringrequiredread-only

Allowed values:api_key

idstring(uuid)requiredread-only

Contains a unique identifier used for this resource.

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

display_namestringrequired
credentialstringrequired

The API key value (only returned on creation)

statusstringread-only

Allowed values:activeexpiredrevoked

expires_atstring | null(date-time)read-only
created_atstring(date-time)requiredread-only

An ISO-8601 timestamp representation of entity creation date.

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

application/json

Update Credential

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

put
/api/v2/applications/{applicationId}/credentials/{credentialId}

Path Parameters

applicationIdstring(uuid)required

Id of the targeted application

credentialIdstringrequired

Id of the targeted credential.
Use the list-credentials endpoint to obtain the id field for each credential.

Body

application/json

Update a credential

UpdateCredentialRequest

* Additional properties are NOT allowed.
display_namestringrequired

<= 255 characters

Response

Credential successfully updated.