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 (string id)

Get a directory attribute mapping

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

Using the GetDirectoryAttrMappingUsingGETWithHttpInfo variant

This returns an ApiResponse object which contains the response data, status code and headers.

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 (string id)

List directory attribute mappings

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

Example

Using the GetDirectoryAttrMappingsUsingGETWithHttpInfo variant

This returns an ApiResponse object which contains the response data, status code and headers.

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 (string id)

Get directory synchronization status

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

Example

Using the GetDirectorySyncStatusInfoUsingGETWithHttpInfo variant

This returns an ApiResponse object which contains the response data, status code and headers.

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 (string id)

Get directory synchronization settings

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

Example

Using the GetDirectorySyncUsingGETWithHttpInfo variant

This returns an ApiResponse object which contains the response data, status code and headers.

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 (string id)

List directory sync settings

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

Example

Using the GetDirectorySyncsUsingGETWithHttpInfo variant

This returns an ApiResponse object which contains the response data, status code and headers.

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 (string id)

Get a directory

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

Example

Using the GetDirectoryUsingGETWithHttpInfo variant

This returns an ApiResponse object which contains the response data, status code and headers.

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 (string id)

Get directory group filter

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

Example

Using the GetGroupFilterUsingGETWithHttpInfo variant

This returns an ApiResponse object which contains the response data, status code and headers.

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 (string id)

List directory group filters

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

Example

Using the GetGroupFiltersUsingGETWithHttpInfo variant

This returns an ApiResponse object which contains the response data, status code and headers.

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 (string searchbaseid)

Get a searchbase

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

Example

Using the GetSearchBaseUsingGETWithHttpInfo variant

This returns an ApiResponse object which contains the response data, status code and headers.

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 (string id)

List directory searchbases

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

Example

Using the GetSearchBasesUsingGETWithHttpInfo variant

This returns an ApiResponse object which contains the response data, status code and headers.

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

Using the ListDirectoriesUsingGETWithHttpInfo variant

This returns an ApiResponse object which contains the response data, status code and headers.

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-