Learn how to enable and configure API access for your instance
Complete API endpoint documentation is available at api.kandji.io. This article walks through generating an API token within your Kandji instance.
API Rate Limit
The Kandji API currently has an API rate limit of 10,000 requests per hour per tenant.
Generate an API Token
Kandji uses instance-level bearer tokens to control access to the API To generate one:
- Log in and click on Settings.
- Click the Access tab.
- Click the Add API Token button to create a new API key.
- After clicking Add API Token, provide a Name and a Description for your API token.
- Click Create.
- Kandji will display a modal with the API token. Click the visibility symbol to expose it or use the Copy Token button to copy the API token to your clipboard, storing it in a safe place. Note: You will not be able to see the token details again.
- Click Next.
- Click Configure to manage the API permissions for this specific token or Skip to change them later.
- After making your modifications, click Save.
- Once you create your first token, you will see your instance-specific API URL.
Modify, Inspect, or Revoke an API Token
After you create an API token for your instance, you can modify its name and permissions or revoke it to prevent further access.
- Click the vertical ellipsis next to the token.
- Click View to display information about the token, including the permissions associated with the token. From this page, you can use the following options:
- Click the Permissions tab to edit the permissions associated with the token
- Click the Activity tab to view the activity of the API token, including:
- Token created
- Token name changed
- Token permissions edited
- In the lower-right corner, click Edit to edit the name of the token
- Click Revoke to invalidate the API token and prevent its further use. If you revoke a token, you will no longer see it in the list of API tokens for your instance.