POST /api/short_url
Api key auth Basic auth

Kibana URLs may be long and cumbersome, short URLs are much easier to remember and share. Short URLs are created by specifying the locator ID and locator parameters. When a short URL is resolved, the locator ID and locator parameters are used to redirect user to the right Kibana page.

application/json

Body Required

  • humanReadableSlug boolean

    When the slug parameter is omitted, the API will generate a random human-readable slug if humanReadableSlug is set to true.

  • locatorId string Required

    The identifier for the locator.

  • params object Required

    An object which contains all necessary parameters for the given locator to resolve to a Kibana location.

    When you create a short URL, locator params are not validated, which allows you to pass arbitrary and ill-formed data into the API that can break Kibana. Make sure any data that you send to the API is properly formed.

  • slug string

    A custom short URL slug. The slug is the part of the short URL that identifies it. You can provide a custom slug which consists of latin alphabet letters, numbers, and -._ characters. The slug must be at least 3 characters long, but no longer than 255 characters.

Responses

  • 200 application/json

    Indicates a successful call.

    Hide response attributes Show response attributes object
    • accessCount integer

      Number of times the short URL has been resolved.

    • accessDate integer(int64)

      Unix epoch (milliseconds) of the last time the short URL was resolved. Set to the creation time when the URL has never been accessed.

    • createDate integer(int64)

      Unix epoch (milliseconds) when the short URL was created.

    • id string

      The identifier for the short URL.

    • locator object
      Hide locator attributes Show locator attributes object
      • id string

        The identifier for the locator.

      • state object

        The locator parameters.

      • version string

        The version of Kibana when the short URL was created.

    • slug string

      A random human-readable slug is automatically generated if the humanReadableSlug parameter is set to true. If it is set to false, a random short string is generated.
POST /api/short_url 
curl \
 --request POST 'https://localhost:5601/api/short_url' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{"locatorId":"DASHBOARD_APP_LOCATOR","params":{"dashboardId":"edf84fe0-e1a0-11e7-b6d5-4dc382ef7f5b","timeRange":{"from":"now-7d","to":"now"}},"slug":"my-dashboard"}'
Request example
Request a short URL that resolves to a dashboard with a preset time range. 
{
  "locatorId": "DASHBOARD_APP_LOCATOR",
  "params": {
    "dashboardId": "edf84fe0-e1a0-11e7-b6d5-4dc382ef7f5b",
    "timeRange": {
      "from": "now-7d",
      "to": "now"
    }
  },
  "slug": "my-dashboard"
}
Response examples (200)
The created short URL record. 
{
  "accessCount": 0,
  "accessDate": 1767225600000,
  "createDate": 1767225600000,
  "id": "c54b04f5d4b3aa3c",
  "locator": {
    "id": "DASHBOARD_APP_LOCATOR",
    "state": {
      "dashboardId": "edf84fe0-e1a0-11e7-b6d5-4dc382ef7f5b",
      "timeRange": {
        "from": "now-7d",
        "to": "now"
      }
    },
    "version": "9.4.0"
  },
  "slug": "my-dashboard"
}