DaVinci Admin Applications
The PingOne DaVinci Admin Applications service provides endpoints to create, read, update, and delete DaVinci applications. This service also includes endpoints to rotate the application key and application secret values.
A DaVinci application configuration is the link between your site and the sign-on flows you have created in DaVinci. The application configuration contains settings to determine how external sites can send requests for flows, what flows can be requested, and how users and resources from other sites are managed.
Assigning admin roles and permissions to this service
Admin role assignments determine access to PingOne APIs. When assigning admin roles to this service, refer to PingOne Permissions by Service for the service-specific permissions.
You can also choose to assign admin roles based on particular service resources. Refer to PingOne Permissions by Resource when assigning admin roles per service resources.
Admin assignments to roles are set by:
Refer to Roles Management for more information.
DaVinci Admin applications data model properties
| Property | Type | Required | Mutable | Description |
|---|---|---|---|---|
|
Object |
Optional |
Mutable |
The collection of API keys associated with this application resource. |
|
Boolean |
Optional |
Mutable |
Specifies whether the API key for this appliction is enabled. |
|
String |
Optional |
Mutable |
The value of the API key. |
|
Date |
N/A |
Read only |
The time when the application was created. |
|
Object |
N/A |
Read only |
The DaVinci company ID (environment ID) object. |
|
String |
N/A |
Read only |
The DaVinci company ID, which is the PingOne environment ID. |
|
String |
N/A |
Read only |
The application ID. |
|
String |
Required |
Mutable |
The application name. |
|
Object |
Optional |
Mutable |
The OAuth configuration for this application resource. |
|
String |
Optional |
Mutable |
The client secret used by this application resource. |
|
Array |
Optional |
Mutable |
The list of redirect URIs configured for this application resource. |
|
Array |
Optional |
Mutable |
The list of logout URIs configured for this application resource. |
|
Array |
Optional |
Mutable |
The list of OAuth scopes configured for this application resource. |
|
Array |
Optional |
Mutable |
The list of OAuth grant types configured for this application resource. |
|
String |
Optional |
Mutable |
A URL to retrieve JWKS keys to verify the authorization request signature. This option takes precedence over |
|
String |
Optional |
Mutable |
A set of JWKS keys to verify the authorization request signature. This property is ignored if |
|
Date |
N/A |
Read only |
The time when the application was last modified. |
Response codes
| Code | Message |
|---|---|
200 |
Successful operation. |
201 |
Successfully created. |
204 |
Successfully removed. No content. |
400 |
The request could not be completed. |
401 |
You do not have access to this resource. |
403 |
You do not have permissions or are not licensed to make this request. |
404 |
The requested resource was not found. |
DaVinci application errors
In addition to the general error codes, DaVinci application operations can return the following errors:
| HTTP status | Top‑level code | Detail code | When it happens and what the response contains |
|---|---|---|---|
400 |
|
|
Message: When and detailsWhen: A Details: One detail per validation error, each with the failing property path as the target. |
400 |
|
|
Message: When and detailsWhen: A Details: |
400 |
|
|
Message: When and detailsWhen: A Details: Detail code |
400 |
|
|
Message: When and detailsWhen: A Details: |
400 |
|
|
Message: When and detailsWhen: A Details: Detail code |
400 |
|
|
Message: When and detailsWhen: A Details: |
403 |
|
None |
Message: When and detailsWhen: The actor lacks the Details: None |
404 |
|
None |
Message: When and detailsWhen: A Details: None |
415 |
|
None |
Message: The server is refusing to service the request because the entity of the request is in a format not supported by the requested resource for the requested method. When and detailsWhen: A key rotation request does not use the Details: None |
500 |
|
None |
Message: When and detailsWhen: The service encounters an unexpected internal failure while processing the request, for example a Details: None |