PingOne Platform APIs

Application Resources Permissions

The PingOne Authorize {{apiPath}}/v1/environments/{{envID}}/resources/{{resourceID}}/applicationPermissions endpoint provides operations to read application resource permissions on the specified PingOne resource identified by its ID in the request URL.

Application resources permissions data model

Property Type Required Mutable Description

action

String

Required

Mutable

The action associated with this permission.

description

String

Optional

Mutable

The resource’s description.

id

String

N/A

Read only

The resource’s unique identifier.

key

String

N/A

Read only

The resource.name:action pair of the permission.

resource

Object

N/A

Read only

An object that identifies the associated application resource.

resource.id

String

N/A

Read only

The ID for the associated application resource.

resource.name

String

N/A

Read only

The name of the associated application resource.

resourceServer.id

String

N/A

Read only

The ID for the associated application resource server.

resourceServer.environment.id

String

N/A

Read only

The ID for the environment associated with the application resource server.

Response codes

Code Message

200

Successful operation.

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.

Application resource permission errors

In addition to the general error codes, application resource permission operations can return the following errors:

HTTP status Top‑level code Detail code When it happens and what the response contains

400

REQUEST_FAILED

CONSTRAINT_VIOLATION

Message: The request could not be completed. There was an issue processing the request.

When and details

When: The GET /resources/{resourceServerId}/applicationPermissions request references a resourceID (resource server ID) that exists but is not a custom PingOne SSO resource

Details: You can only perform this operation on custom PingOne SSO resources.

403

ACCESS_FAILED

None

Message: The actor attempting to perform the request is not authorized.

When and details

When: The actor lacks the applicationRoles:read:applicationPermission permission (GET operations)

Details: None.

404

NOT_FOUND

None

Message: The request could not be completed. The requested resource was not found.

When and details

When: The GET /resources/{resourceServerId}/applicationPermissions request references a resource server ID that does not exist

Details: None.