Get an application registration

Retrieves the specified product registration for an application.

get
/api/v2/applications/{applicationId}/registrations/{registrationId}

Path Parameters

applicationIdstring(uuid)required

Id of the targeted application

registrationIdstring(uuid)required

Contains a unique identifier used by the Portal API for this resource.

Response

application/json

Get registration response.

GetRegistrationResponse

* Additional properties are NOT allowed.
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

statusstringrequired

The approval status of the registration.

Allowed values:approvedpendingrejectedrevoked

product_idstring(uuid)required

Contains a unique identifier used by the Portal API for this resource.

product_namestringrequired

The name of the product. This is the name that is displayed in the developer portal.

product_version_idstring(uuid)required

Contains a unique identifier used by the Portal API for this resource.

product_version_namestringrequired

The name of the product version. This is the version label that is displayed in the developer portal.

application_idstring(uuid)required

Contains a unique identifier used by the Portal API for this resource.

granted_scopesarray[string]DEPRECATED

Cached list of scopes granted for the given application registration.
Use /api/v2/applications/{applicationId}/registrations/{registrationId}/granted-scopes to get up to date granted scopes from the IDP.
This property will be omitted if not supported by the application.

application/json

Delete an application registration

Unregister an application for a product version.

delete
/api/v2/applications/{applicationId}/registrations/{registrationId}

Path Parameters

applicationIdstring(uuid)required

Id of the targeted application

registrationIdstring(uuid)required

Contains a unique identifier used by the Portal API for this resource.

Response

The registration has been deleted.

Get App Registration Granted Scopes

Retrieves the granted scopes of a specified product registration directly from the IDP for an application.
Will return 409 if this feature is not supported by the application.

get
/api/v2/applications/{applicationId}/registrations/{registrationId}/granted-scopes

Path Parameters

applicationIdstring(uuid)required

Id of the targeted application

registrationIdstring(uuid)required

Contains a unique identifier used by the Portal API for this resource.

Response

application/json

Get granted scopes response.

GetGrantedScopesResponse

* Additional properties are NOT allowed.
scopesarray[string]required

List of granted scopes, directly updated from the IDP

application/json

CreateRegistrationPayload

object

The payload to create a registration.

* Additional properties are NOT allowed.
product_version_idstring(uuid)required

The product version id required for registration.

scopesarray[string]

The requested scopes for the registration, requires developer_managed_scopes to be enabled.

Example

ListRegistrationsResponse

object
* Additional properties are NOT allowed.
metaobjectrequired

returns the pagination information

Show Child Parameters
dataarray[object]required
* Additional properties are NOT allowed.
Show Child Parameters
Example