Problem Definition

Currently, the directory Id is a mandatory path parameter used in many API requests. However, we don't have an API endpoint that can retrieve directory details like, the ID, name, whether it's local or synced. 

Examples of API requests where the directory Id is a mandatory path parameter:

Get groups in an org: https://developer.atlassian.com/cloud/admin/organization/rest/api-group-groups/#api-v2-orgs-orgid-directories-directoryid-groups-get

Get users: https://developer.atlassian.com/cloud/admin/user-provisioning/rest/api-group-users/#api-scim-directory-directoryid-users-get

Suggested Solution

Provide an API that can query the directory details.

Why this is important

This will help to retrieve the directory ID and type without checking it on the admin hub. 

Workaround

1. The ID of external directories can be retrieved while configuring SCIM provisioning or by regenerating the API key of the SCIM directory.
2. The support team can help to retrieve directory IDs.