Skip to content

Order Management System REST API - Identity Controller

The Identity Controller is responsible for retrieving and manipulating registered Identities, which are services or users able to login and perform operations on this service.

GET /identity

Performing a GET on this URL retrieves all Identity permissions.

ParameterExpectedDescription
asAtOptionalAn ISO8601 date and time. The results returned will be those at the given timestamp. If omitted, returns the latest results.

On success, a 200 response containing an array of Permissions objects.

POST /identity

Performing a POST to this URL adds or updates an Identity.

Note: When no Identities have been registered with the service, this endpoint simply requires a valid access token, and does not perform any security checks.

A single Permissions object.

On success, a 204 response with no body. On failure, a 422 response with a body containing an array of one or more error codes describing the problem.