List markdown library items Experimental; added in 9.6.0

GET /api/markdowns
Api key auth Basic auth

Spaces method and path for this operation:

get /s/{space_id}/api/markdowns

Refer to Spaces for more information.

Returns a paginated list of markdown library items. Each result includes title, description, and metadata, but not the content. Use GET /api/markdowns/{id} to retrieve the complete state.

Query parameters

  • page number

    The page of results to return.

    Minimum value is 1. Default value is 1.

  • per_page number

    The number of results to return per page.

    Minimum value is 1, maximum value is 1000. Default value is 20.

  • query string

    Filters results by title and description using Elasticsearch simple_query_string syntax. Multi-word terms require all words to match.

Responses

  • 200 application/json

    success

    Hide response attributes Show response attributes object
    • data array[object] Required

      List of markdown library items matching the query.

      At least 0 but not more than 1000 elements.

      Hide data attributes Show data attributes object
      • data object Required

        Additional properties are NOT allowed.

        Hide data attributes Show data attributes object
        • description string

          A short description of the markdown library item.

        • title string Required

          The markdown library item title.

      • id string Required

        The markdown library item ID.

      • meta object Required

        Additional properties are NOT allowed.

        Hide meta attributes Show meta attributes object
        • created_at string

          Timestamp when the object was created (ISO 8601).

        • created_by string

          User profile ID of the user who created the object.

        • managed boolean

          When true, the object is managed by Kibana and cannot be edited by users.

        • owner string

          Identifier of the plugin or team that owns this object.

        • updated_at string

          Timestamp when the object was last updated (ISO 8601).

        • updated_by string

          User profile ID of the user who last updated the object.

        • version string

          Internal version identifier for optimistic concurrency control.

    • meta object Required

      Additional properties are NOT allowed.

      Hide meta attributes Show meta attributes object
      • page number

        The returned page of results.

        Minimum value is 1. Default value is 1.

      • per_page number

        The number of results returned per page.

        Minimum value is 1, maximum value is 1000. Default value is 20.

      • total number Required

        The total number of results matching the query.
  • 403

    forbidden

GET /api/markdowns 
curl -X GET "${KIBANA_URL}/api/markdowns?query=welcome&per_page=10" \
  -H "Authorization: ApiKey ${API_KEY}"

GET kbn:/api/markdowns?query=welcome&per_page=10
Response examples (200)
Paginated list of markdown library item summaries. Each item includes the ID, a subset of state fields (`title` and `description`), and metadata. The full `content` is not included; use `GET /api/markdowns/{id}` to retrieve a specific item. 
{
  "data": [
    {
      "data": {
        "description": "Intro and context for the web logs dashboard.",
        "title": "Web logs overview"
      },
      "id": "5e1f3a20-c4d6-11ef-be8b-3c7c2b9d1f4e",
      "meta": {
        "created_at": "2026-04-13T10:00:00.000Z",
        "managed": false,
        "updated_at": "2026-04-13T10:00:00.000Z",
        "version": "WzU5LDFd"
      }
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 20,
    "total": 1
  }
}