Send Requests

Use the following guidelines when sending requests using the Oracle Unified Directory SCIM REST API.

URL Structure

Access the Oracle Unified Directory SCIM REST API resources using the following URL structure:

https://<subdomain>.<domain>.com:<port>/<resource-path>
Where:
  • <subdomain.domain>.com:<port> is the host and port where Oracle Unified Directory is running.

  • <resource-path> is the relative path that defines the resource.

Supported Methods

You can perform basic CRUD operations (create, read, update, and delete) on Oracle Unified Directory using standard HTTP method requests, as summarized in the following table.

HTTP Method Description
GET

Retrieve information about one or more complete or partial resources.

POST

Creates new resources or creates search requests, depending on the endpoint.

PATCH

Modifies a resource with a set of client-specified changes (partial updates).

DELETE

Deletes a resource.

Media Types

The following media types are supported by the Oracle Unified Directory SCIM REST API:

  • application/json

Supported Headers

The Oracle Unified Directory SCIM REST API supports the following headers that may be passed in the header section of the HTTP request or response.

Header Description Example

Content-Type

Media type of the body of the request. Required for POST and PUT requests.

Content-Type: application/json

ResponseTime

The time in milliseconds to process the request.

ResponseTime: 1000

Authorization

Authentication credentials for HTTP authentication.