Enterprise License API

    Checks if a valid license is available.

    Example request:

    Example response:

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

    Status codes:

    • 200 - OK

    POST /api/licensing/token/renew

    Manually ask license issuer for a new token.

    Example request:

    Example response:

    1. HTTP/1.1 200 OK
    2. Content-Type: application/json
    3. Content-Length: 357
    4. {
    5.   "jti":"2",
    6.   "iss":"https://grafana.com",
    7.   "sub":"https://play.grafana.org/"
    8.   "lid":"1",
    9.   "included_admins":5,
    10.   "included_viewers":10,
    11.   "lic_exp_warn_days":30,
    12.   "tok_exp_warn_days":2,
    14.   "prod":["grafana-enterprise"],
    15.   "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.

    Status Codes:

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

    DELETE /api/licensing/token

    Removes the license stored in the Grafana database.

    Example request:

    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