1
0
mirror of https://github.com/Unleash/unleash.git synced 2024-12-28 00:06:53 +01:00
unleash.unleash/docs/advanced/api_access.md

34 lines
1.3 KiB
Markdown
Raw Normal View History

---
id: api_access
title: API Access
---
It is possible to integrate directly with the Admin API. In this guide we will explain all the steps to set it up.
## Step 1: Create API token
Please refer to [Create token](../user_guide/api-token) on how to create an API token. You'll need a token with `Admin` level access for this to work.
Please note that it may take up to 60 seconds for the new key to propagate to all Unleash-hosted instances.
> If you need an API token to use in a client SDK you should create a "client token" as these have less access.
## Step 2: Use Admin API
Now that you have an access token with admin privileges we can use that to perform changes in our Unleash-hosted instance.
In the example below we will use the [Unleash Admin API](../api/admin/features) to enable the “Demo” feature toggle sing curl.
```sh
curl -X POST -H "Authorization: admintoken"
https://app.unleash-hosted.com/demo/api/admin/features/Demo/toggle/on
```
**Great success!** We have now enabled the feature toggle. We can also verify that it was actually changed by the API user by navigating to the history (audit log) for this feature toggle.
![Create token](../assets/api_access_history.png)
## API overview
You can find the full documentation on everything the Unleash API supports in the [Unleash API documentation](../api/admin/features).