Short URL API

{{< docs/shared lookup="developers/deprecated-apis.md" source="grafana" version="<GRAFANA_VERSION>" >}}

{{< admonition type="note" >}} Grafana announced the deprecation of this API on September 23, 2026. Use the shorturl.grafana.app/v1beta1 API group instead:

• Create a short URL: POST /apis/shorturl.grafana.app/v1beta1/namespaces/{namespace}/shorturls
• Retrieve a short URL: GET /apis/shorturl.grafana.app/v1beta1/namespaces/{namespace}/shorturls/{name}

The new API uses different request and response shapes than the endpoints on this page, so changing the URL alone isn't enough. Refer to the Short URL API Swagger documentation for the schemas, and to API structure in Grafana for how to determine the {namespace} for your instance. {{< /admonition >}}

Use this API to create shortened URLs. A short URL represents a longer URL containing complex query parameters in a smaller and simpler format.

Create short URL

POST /api/short-urls

Creates a short URL.

Example request:

POST /api/short-urls HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer <SERVICE_ACCOUNT_TOKEN>

{
  "path": "d/TxKARsmGz/new-dashboard?orgId=1&from=1599389322894&to=1599410922894"
}

JSON body schema:

• path – The path to shorten, relative to the Grafana root_url.

Example response:

HTTP/1.1 200
Content-Type: application/json

{
  "uid": AT76wBvGk,
  "url": http://localhost:3000/goto/AT76wBvGk?orgId=1
}

Status codes:

• 200 – Created
• 400 – Errors (invalid JSON, missing or invalid fields)