License Vault Help

License Vault API

The License Vault API offers a set of methods for accessing license usage data programmatically and automating license management. Here's what you can do via the API:

For more information about the API methods, consult the API specification. You can access it from your License Vault by following the steps below.

  1. Log in to License Vault with administrator credentials.

  2. In the menu on the left, select Settings. Then scroll down to the License Vault API section and click the API specification link.

    The link to the License Vault API specification
  3. The link will take you to the Swagger-format specification.

Authorized access to the API

For authorized access to the API methods, you'll need to generate an access token that serves as a key to the License Vault data.

Once the token is generated, pass it to the Authorization parameter of your API requests. For example:

GET https://mycompany.fls.jetbrains.com Authorization: Bearer <your-access-token-goes-here> Accept: application/json

To generate an access token

  1. Log in to License Vault with administrator credentials.

  2. In the menu on the left, select Settings. Then scroll down to the API access token section.

    The interface that lets you generate an API access token in License Vault.
  3. Click Generate token. If you don't see this button, colsult the relevant section below.

  4. You will see a dialog with the access token displayed. Click Copy to copy your token to the clipboard, and be sure to save it in a secure location before closing the dialog.

    The dialog that shows you the generated API token.

What if I don't see the Generate token button?

If you see the Generate new token and Delete token buttons instead, you or another administrator has already generated an API access token for your License Vault.

We show the token only once to the administrator who generates it. If you don't have your token, contact other License Vault administrators in your company to obtain it or consider generating a new one.

Token security and lifetime

Each License Vault can have only one unique access token. All License Vault administrators can generate and delete it. Once the token is generated, it remains valid until one of the administrators deletes it or generates a new one.

Store your token in a secure location and don't share it with anyone unless you want them to have full access via the API to the license usage data stored in your License Vault.

  1. Go to the API access token settings by following steps 1 and 2 from the instructions above.

  2. Click Generate new token.

    The interface that lets you generate a new access token.
  3. Click Generate new token in the dialog that pops up.

  4. Copy and save the new token as described in step 4 of the instructions above.

  1. Go to the API access token settings by following steps 1 and 2 from the instructions above.

  2. Click Delete token.

    The interface that lets you delete the access token.
  3. Click Delete token in the dialog that pops up.

Last modified: 23 October 2024