PingDirectory

API paths

The Configuration API is available under the /config path.

A full listing of root sub-paths can be obtained from the /config/ResourceTypes endpoint:

GET /config/ResourceTypes
Host: example.com:5033
Accept: application/scim+json

Sample response (abbreviated):

{
				"schemas": [
				"urn:ietf:params:scim:api:messages:2.0:ListResponse"
				],
				"totalResults": 520,
				"Resources": [
				{
				"schemas": [
				"urn:ietf:params:scim:schemas:core:2.0:ResourceType"
				],
				"id": "dsee-compat-access-control-handler",
				"name": "DSEE Compat Access Control Handler",
				"description": "The DSEE Compat Access Control
				Handler provides an implementation that uses syntax
				compatible with the Sun Java System Directory Server
				Enterprise Edition access control handler.",
				"endpoint": "/access-control-handler",
				"meta": {
				"resourceType": "ResourceType",
				"location": "http://example.com:5033/config/ResourceTypes/dsee-compataccess-
				control-handler"
				}
				},
				{
				"schemas": [
				"urn:ietf:params:scim:schemas:core:2.0:ResourceType"
				],
				"id": "access-control-handler",
				"name": "Access Control Handler",
				"description": "Access Control Handlers manage the
				application-wide access control. The server's access
				control handler is defined through an extensible
				interface, so that alternate implementations can be created.
				Only one access control handler may be active in the server
				at any given time.",
				"endpoint": "/access-control-handler",
				"meta": {
				"resourceType": "ResourceType",
				"location": "http://example.com:5033/config/ResourceTypes/accesscontrol-
				handler"
				}
				},
				{
				...

The response’s endpoint elements enumerate all available sub-paths. The path /config/access-control-handler in the example can be used to get a list of existing access control handlers, and create new ones. A path containing an object name like /config/backends/{backendName}, where {backendName} corresponds to an existing backend (such as userRoot) can be used to obtain an object’s properties, update the properties, or delete the object.

Some paths reflect hierarchical relationships between objects. For example, properties of a local DB VLV index for the userRoot backend are available using a path like /config/backends/userRoot/local-db-indexes/uid. Some paths represent singleton objects, which have properties but cannot be deleted nor created. These paths can be differentiated from others by their singular, rather than plural, relation name (for example global-configuration).