Identity Broker REST API Reference

UnboundID Logo

/policysets/{id}

This resource is available only to principals with these entitlements: "ROLE_READ_POLICYSET" "ROLE_BROKER_ADMIN"

Mount Point: /auth/api/v1/policysets/{id}/

The following operations are supported on this resource:

GET

This operation is available only to principals with these entitlements: "ROLE_READ_POLICYSET" "ROLE_BROKER_ADMIN"

Retrieve a specified policy set.

Parameters

name description type default
id Either a Xacml policy set ID (URN) or the policy set's dataStore Id. path

Response Body

result: persistedPolicySet
media types: application/json

The requested policy set.

Status Codes

code description
200 Success
404 No such object

PUT

This operation is available only to principals with these entitlements: "ROLE_UPDATE_POLICYSET" "ROLE_BROKER_ADMIN"

Update properties of the specified policy set.

Parameters

name description type default
id Either a Xacml policy set ID (URN) or the policy set's dataStore Id. path

Request Body

element: persistedPolicySet
media types: application/json

contains new values for the policy set. Any null values are ignored.

Response Body

result: persistedPolicySet
media types: application/json

PersistedPolicySet updated policy set.

Status Codes

code description
200 Success
409 Reserved for cache object out of date

DELETE

This operation is available only to principals with these entitlements: "ROLE_DELETE_POLICYSET" "ROLE_BROKER_ADMIN"

Deletes the specified policy set.

Parameters

name description type default
id Either a Xacml policy set ID (URN) or the policy set's dataStore Id. path
force true to delete regardless of existing references to the policy set, or false to fail if there are existing references. query

Status Codes

code description
204 Success
404 No such object