PingOne Platform APIs

Decision Endpoints

The PingOne policy decision service provides operations to create, read, update and delete decision policy versions in PingOne.

Policy decision service data model

Property Type? Required? Mutable? Description

alternateId

UUID

Optional

Mutable

A string that specifies alternative unique identifier for the endpoint, which provides a method for locating the resource by a known, fixed identifier.

authorizationVersion.id

UUID

Optional

Mutable

A string that specifies the ID of the Authorization Version deployed to this endpoint. Versioning allows independent development and deployment of policies. If omitted, the endpoint always uses the latest policy version available from the policy editor service.

authorizationVersion.href

String

Optional

Mutable

A string that specifies the request URL for the authorization version endpoint.

authorizationVersion.title

String

Optional

Mutable

A string that specifies the title for the authorization version response.

authorizationVersion.type

String

Optional

Mutable

A string that specifies the content type for the authorization version response.

description

String

Required

Mutable

A string that specifies the description of the policy decision resource.

id

UUID

Required

Mutable

A string that specifies the resource’s unique identifier.

name

String

Required

Mutable

A string that specifies the policy decision resource name.

owned

Boolean

Optional

Mutable

A boolean that when true restricts modifications of the endpoint to PingOne-owned clients.

policyId

UUID

Optional

Mutable

A string that specifies the ID of the root policy configured for this endpoint. If omitted, the policy editor service decides on a suitable default.

recentDecisionsEnabled

Boolean

Optional

Mutable

A boolean that specifies whether to show recent decisions.

recentDecisions.href

String

Optional

Mutable

A string that specifies the request URL for the recent decisions endpoint.

recentDecisions.title

String

Optional

Mutable

A string that specifies the title for the recent decisions response.

recentDecisions.type

String

Optional

Mutable

A string that specifies the content type for the recent decisions response.

recordRecentRequests

Boolean

Required

Mutable

A boolean that specifies whether to record a limited history of recent decision requests and responses, which can be queried through a separate API.

Policy decision management events generated

Refer to Audit Reporting Events for the events generated.

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.