Skip to main content

DirectoriesApi

MethodHTTP requestDescription
getDirectoryAttrMappingUsingGETGET /api/web/v1/attributemappings/{id}Get a directory attribute mapping
getDirectoryAttrMappingsUsingGETGET /api/web/v1/directories/{id}/attributemappingsList directory attribute mappings
getDirectorySyncStatusInfoUsingGETGET /api/web/v1/directorysyncinfo/{id}Get directory synchronization status
getDirectorySyncUsingGETGET /api/web/v1/directorysyncs/{id}Get directory synchronization settings
getDirectorySyncsUsingGETGET /api/web/v1/directories/{id}/directorysyncsList directory sync settings
getDirectoryUsingGETGET /api/web/v1/directories/{id}Get a directory
getGroupFilterUsingGETGET /api/web/v1/groupfilters/{id}Get directory group filter
getGroupFiltersUsingGETGET /api/web/v1/directories/{id}/groupfiltersList directory group filters
getSearchBaseUsingGETGET /api/web/v1/searchbases/{searchbaseid}Get a searchbase
getSearchBasesUsingGETGET /api/web/v1/directories/{id}/searchbasesList directory searchbases
listDirectoriesUsingGETGET /api/web/v1/directoriesList directories

getDirectoryAttrMappingUsingGET

DirectoryAttributeMapping getDirectoryAttrMappingUsingGET(id)

Get a directory attribute mapping

Get the specified directory attribute mapping. Caller requires the DIRECTORIES:VIEW permission.

Parameters

NameTypeDescriptionNotes
idStringThe UUID of the directory attribute mapping to be returned.

Return type

DirectoryAttributeMapping

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-

getDirectoryAttrMappingsUsingGET

List<DirectoryAttributeMapping> getDirectoryAttrMappingsUsingGET(id)

List directory attribute mappings

List all directory attribute mappings for a given directory. Caller requires the DIRECTORIES:VIEW permission.

Example

Parameters

NameTypeDescriptionNotes
idStringThe UUID of the directory whose directory attribute mappings are to be returned.

Return type

List<DirectoryAttributeMapping>

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-

getDirectorySyncStatusInfoUsingGET

DirectorySyncStatusInfo getDirectorySyncStatusInfoUsingGET(id)

Get directory synchronization status

Get the specified directory synchronization status details. Caller requires the DIRECTORIES:VIEW permission.

Example

Parameters

NameTypeDescriptionNotes
idStringThe UUID of the directory whose synchronization status is to be returned.

Return type

DirectorySyncStatusInfo

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-

getDirectorySyncUsingGET

DirectorySync getDirectorySyncUsingGET(id)

Get directory synchronization settings

Get the specified directory synchronization settings. Caller requires the DIRECTORIES:VIEW permission.

Example

Parameters

NameTypeDescriptionNotes
idStringThe UUID of the directory synchronization settings to be returned.

Return type

DirectorySync

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-

getDirectorySyncsUsingGET

List<DirectorySync> getDirectorySyncsUsingGET(id)

List directory sync settings

List all directory sync settings associated with the given directory sync agent. Caller requires the DIRECTORIES:VIEW permission.

Example

Parameters

NameTypeDescriptionNotes
idStringThe UUID of the directory sync agent whose directory sync settings are to be returned.

Return type

List<DirectorySync>

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-

getDirectoryUsingGET

Directory getDirectoryUsingGET(id)

Get a directory

Get the specified directory. Caller requires the DIRECTORIES:VIEW permission.

Example

Parameters

NameTypeDescriptionNotes
idStringThe UUID of the directory to be returned.

Return type

Directory

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-

getGroupFilterUsingGET

GroupFilter getGroupFilterUsingGET(id)

Get directory group filter

Get the specified directory group filter. Caller requires the DIRECTORIES:VIEW permission.

Example

Parameters

NameTypeDescriptionNotes
idStringThe UUID of the directory group filter to be returned.

Return type

GroupFilter

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-

getGroupFiltersUsingGET

List<GroupFilter> getGroupFiltersUsingGET(id)

List directory group filters

List all directory group filters for a given directory. Caller requires the DIRECTORIES:VIEW permission.

Example

Parameters

NameTypeDescriptionNotes
idStringThe UUID of the directory whose group filters are to be returned.

Return type

List<GroupFilter>

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-

getSearchBaseUsingGET

SearchBase getSearchBaseUsingGET(searchbaseid)

Get a searchbase

Get the specified searchbase. Caller requires the DIRECTORIES:VIEW permission.

Example

Parameters

NameTypeDescriptionNotes
searchbaseidStringThe UUID of the searchbase to be returned.

Return type

SearchBase

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-

getSearchBasesUsingGET

List<SearchBase> getSearchBasesUsingGET(id)

List directory searchbases

List all searchbases for a given directory. Caller requires the DIRECTORIES:VIEW permission.

Example

Parameters

NameTypeDescriptionNotes
idStringThe UUID of the directory whose searchbases are to be returned.

Return type

List<SearchBase>

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-

listDirectoriesUsingGET

List<Directory> listDirectoriesUsingGET()

List directories

List all directories. Caller requires the DIRECTORIES:VIEW permission.

The following attributes are not included in the returned Directory object: directoryAttributeMappings, directorySync, groupFilters, searchBases. The get directory API can be used to acquire these attribute for a specific directory.

Example

Parameters

This endpoint does not need any parameter.

Return type

List<Directory>

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-