Get the Guide to Modern IGA

ConductorOne docs

Introducing ConductorOne's API

The ConductorOne API can be used to access data, automate tasks, and create integrations. Full details about the API are available on our API docs site.

The ConductorOne application programming interface (API) is a set of rules that defines how ConductorOne can communicate with other software programs. The ConductorOne API lets developers access ConductorOne data and functionality, automate workflows, and connect ConductorOne to other tools and interfaces.

Get started with the ConductorOne API

To get started with the ConductorOne API, go to the API docs site, which includes full details on the API’s methods, parameters, and responses, as well as instructions on how to authenticate requests to the API.

Generate a personal API key

Create a personal API key to use when working with the ConductorOne API.

  1. In the ConductorOne web app, open your profile menu and select API keys.

  2. Click Create credential.

  3. Give your new API key a name and select whether the key will expire.

  4. Optional. To limit where the API key can make requests from, enter the allowed IP addresses in the Limit source IPs field. Specific IP addresses and CIDRs are both accepted.

  5. Select the scope of the API key:

    • Full permissions: Gives the API key full read-write access.

    • Read-only Super Administrator: Gives the API key full read-only access.

    • Read-only to system logs: Gives the API key access limited to reading system logs. API keys with this permission are ideal to use when setting up system logs.

  6. Click Create.

  7. Your new API key is created and the client ID and client secret are shown. Carefully copy and save the client secret, as it won’t be shown again.

The API key is added to list of your personal API clients, and its client ID and usage data for the key are shown. If needed, you can delete the API key from this page.