Enterprise License API

If you are running Grafana Enterprise and have Fine-grained access control enabled, for some endpoints you would need to have relevant permissions. Refer to specific resources to understand what permissions are required.

Checks if a valid license is available.

See note in the for an explanation.

Examples

Example request:

Example response:

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 4
true

POST /api/licensing/token/renew

Manually ask license issuer for a new token.

See note in the for an explanation.

Examples

Example request:

Example response:

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 357
{
  "jti":"2",
  "iss":"https://grafana.com",
  "sub":"https://play.grafana.org/"
  "lid":"1",
  "included_admins":5,
  "included_viewers":10,
  "lic_exp_warn_days":30,
  "tok_exp_warn_days":2,
  "company":"Grafana Labs"
}

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

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

DELETE /api/licensing/token

Removes the license stored in the Grafana database.

See note in the for an explanation.

Examples

Example request:

JSON Body schema:

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

Example response:

HTTP/1.1 202 Accepted
Content-Type: application/json
Content-Length: 2
{}

• 202 - Accepted, license removed or did not exist.
• 401 - Unauthorized
• 403 - Access denied