This topic describes the information you need to get started with testing our APIs directly from the reference documentation.
Collect tenant specific information
In order to use the reference documentation to send requests to APIs in your CyberArk Identity tenant, you need to collect information specific to your tenant, and configure your tenant to allow requests from identity-developer.cyberark.com.
Information | Description |
---|---|
tenant ID | A unique identifier for your tenant. This is a required request parameter for many APIs. To find your tenant ID, click your username icon, then select About. |
tenant URL | The URL for your CyberArk Identity tenant. The tenant URL is .my.idaptive.app. The tenant URL is a required parameter for all endpoints. Without it, you can't send requests to endpoints on your tenant. When you enter the tenant URL in the parameter field, "https://" is not required. |
Enable the Try It! functionality
You can now click Try it! to test requests to endpoints from the developer documentation, and see responses specific to your CyberArk Identity tenant.
To enable Try it! for your tenant
- In the CyberArk Identity Admin Portal, go to Settings > Authentication > Security Settings, then add identity-developer.cyberark.com to the list of trusted DNS domains for API calls.
Specify trusted domains for API calls to prevent cross-origin resource sharing attacks before making the API calls from the Identity developer portal.
Note
This example adds the domain for this documentation site as a trusted domain. You can add any domain that you plan to send requests from.
- In https://identity-developer.cyberark.com/reference, select an endpoint from the table of contents.
- Enter required parameters, select a language, then click Try it!.
The response to the request to your tenant displays in the RESPONSE section.