Enterprise License API

Licensing is only available in Grafana Enterprise. Read more about Grafana Enterprise.

Check license availability

Note: Available in Grafana Enterprise v7.4+.

GET /api/licensing/check

Checks if a valid license is available.

Example request:

  1. GET /api/licensing/check
  2. Accept: application/json
  3. Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

Example response:

  1. HTTP/1.1 200 OK
  2. Content-Type: application/json
  3. Content-Length: 4
  5. true

Status codes:

  • 200 - OK

Manually force license refresh

Note: Available in Grafana Enterprise v7.4+.

POST /api/licensing/token/renew

Manually ask license issuer for a new token.

Example request:

  1. POST /api/licensing/token/renew
  2. Accept: application/json
  3. Content-Type: application/json
  4. Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
  6. {}

Example response:

  1. HTTP/1.1 200 OK
  2. Content-Type: application/json
  3. Content-Length: 357
  5. {
  6.   "jti":"2",
  7.   "iss":"https://grafana.com",
  8.   "sub":"https://play.grafana.org/"
  9.   "lid":"1",
  10.   "included_admins":5,
  11.   "included_viewers":10,
  12.   "lic_exp_warn_days":30,
  13.   "tok_exp_warn_days":2,
  14.   "update_days":1,
  15.   "prod":["grafana-enterprise"],
  16.   "company":"Grafana Labs"
  17. }

The response is a JSON blob available for debugging purposes. The available fields may change at any time without any prior notice.

Status Codes:

  • 200 - OK
  • 401 - Unauthorized
  • 403 - Access denied

Remove license from database

Note: Available in Grafana Enterprise v7.4+.

DELETE /api/licensing/token

Removes the license stored in the Grafana database.

Example request:

  1. DELETE /api/licensing/token
  2. Accept: application/json
  3. Content-Type: application/json
  4. Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
  6. {"instance": "http://play.grafana.org/"}

JSON Body schema:

  • instance – Root URL for the instance for which the license should be deleted. Required.

Example response:

  1. HTTP/1.1 202 Accepted
  2. Content-Type: application/json
  3. Content-Length: 2
  5. {}

Status codes:

  • 202 - Accepted, license removed or did not exist.
  • 401 - Unauthorized
  • 403 - Access denied
  • 422 - Unprocessable entity, incorrect instance name provided.