Directories

Path:/organization/v3/directories

This endpoint provides management of Directories belonging to an Organization.

GET

Gets all of the Directories that belong to an Organization.

Request

The request has no body or query parameters.

Response

Responses will be a JWE encrypted JSON payload consisting of an array of Directories with the following attributes:

id (string):The globally unique identifier for the Directory.
name (string):The name of the Directory.
active (boolean):A boolean value that answers: “Is the Directory key active?”
premium (boolean):Unused at this time
service_ids (string[]):An array of Service IDs for the Directory.
sdk_keys (string[]):An array of Authenticator SDK Keys for the Directory. Authenticator SDK Keys are utilized by Mobile Authenticators when linking User Devices to a Directory.
android_key (string):The key used for communicating with Android based push notification services on behalf of this Directory.
ios_certificate_fingerprint (string):The fingerprint of the Certificate for communicating with iOS based push notification services on behalf of the Directory.
denial_context_inquiry_enabled (boolean):A boolean value that indicates if the authorization denial context feature is enabled.
webhook_url (string) [optional]:The URL for web hooks tied to this Directory.

Example of the result for an Organization with Directories:

[
    {
        "id": "ce5ab88c-e79e-4049-bb36-4f8709122648",
        "name": "Directory One",
        "active": true,
        "premium": true,
        "service_ids": ["ea6c2394-819c-4f09-9110-3a28a2f92699", "09d974c1-d0ef-4de4-b34d-abec8a113a7d"],
        "sdk_keys": ["4abce20a-3cf8-40a5-bff2-418d6945c404"],
        "android_key": "2349872039AE0923DF4",
        "ios_certificate_fingerprint": "ca:86:58:c6:f9:f5:b1:88:7b:dd:da:cc:74:e5:63:ed:78:b1:38:23:7d:6c:48:f9:71:9b:63:1b:ba:60:1d:97",
        "denial_context_inquiry_enabled": true,
        "webhook_url": "https://my.website.com/webhooks/directory"
    },
    {
        "id": "b11869ab-ceb3-417e-a5ba-ca403e678f12",
        "name": "Directory 2",
        "active": false,
        "premium": true,
        "service_ids": [],
        "sdk_keys": [],
        "android_key": null,
        "ios_certificate_fingerprint": null,
        "denial_context_inquiry_enabled": null,
        "webhook_url": null
    }
]

Example of the result for an Organization without Directories:

[]

POST

Creates a Directory under an Organization.

Request

Requests will be a JWE encrypted JSON payload with the following attribute:

name (string):The desired name of the Directory. Directory names are required to be unique within an Organization. If the name provided is in use by another Directory for the same Organization, a 400 Invalid Request response will be returned along with an error body having the error code ORG-003.

Example:

{"name": "Directory One"}

Response

Responses will be a JWE encrypted JSON payload consisting of the identifier of the Directory just created.

id (string):The Identifier of the Directory created.

Example:

{
    "id": "ce5ab88c-e79e-4049-bb36-4f8709122648"
}

PATCH

Updates a Directory.

Request

Requests will be a JWE encrypted JSON payload with the following attributes:

directory_id (string):The identifier for the Directory.
active (boolean) [optional]:A boolean that indicates the active status of the Directory.
android_key (string) [optional]:The key used for communicating with Android based push notification services on behalf of this Directory.
ios_p12 (string) [optional]:The PKCS #12 formatted key and certificate for communicating with iOS based push notification services on behalf of the Directory.
denial_context_inquiry_enabled (boolean) [optional]:
 A boolean value that indicates if the authorization denial context feature is enabled.
webhook_url (string) [optional]:The URL to which web hooks for this Directory will be made.

Example:

{
     "directory_id": "ce5ab88c-e79e-4049-bb36-4f8709122648",
     "active": true,
     "android_key": "2349872039AE0923DF4",
     "ios_p12": "this_would_be_a_valid_iOS_p12_formatted_key_and_certificate",
     "denial_context_inquiry_enabled": true,
     "webhook_url": "https://my.website.com/webhooks/directory"
 }

Response

There is no response data.

User Contributed

TransUnion links to user contributed code as a resource to its community. TransUnion does not in any way guarantee or warrant the quality and security of these code bases. User contributed code is supported by the creators. If you do find a link from the site to user contributed code that is malicious or inappropriate in any way, please report that link to TransUnion immediately and we will investigate the claim. Submit any issue to TransUnion support at https://transunion.com/support. ×