Spaces method and path for this operation:
post /s/{space_id}/api/markdowns
Refer to Spaces for more information.
Creates a new markdown library item and returns its ID, full state, and metadata.
Body
-
The Markdown text rendered by the panel. Supports GitHub-flavored Markdown, including headings, paragraphs, lists, links, images, tables, blockquotes, and code blocks. Use
\nfor line breaks within JSON strings. -
A short description of the markdown library item.
-
Display settings for the markdown panel.
Default value is
{"open_links_in_new_tab" => true}. Additional properties are NOT allowed. -
The markdown library item title.
Minimum length is
1.
POST
/api/markdowns
Create a markdown library item - cURL
curl -X POST "${KIBANA_URL}/api/markdowns" \
-H "Authorization: ApiKey ${API_KEY}" \
-H "kbn-xsrf: true" \
-H "Content-Type: application/json" \
-d '{
"title": "Web logs overview",
"description": "Intro and context for the web logs dashboard.",
"content": "## Web logs overview\n\nA quick reference for the **Kibana sample web logs** dataset (`kibana_sample_data_logs`).\n\n**Key metrics in this dashboard:**\n\n- Total request count by HTTP method\n- Average response size over time\n- Geographic distribution of client IPs\n\n> Use the time picker above to narrow the dashboard to an incident window.\n\nFor field reference, see the [sample data documentation](https://www.elastic.co/docs/manage-data/ingest/sample-data).\n",
"settings": {
"open_links_in_new_tab": true
}
}'
POST kbn:/api/markdowns
{
"title": "Web logs overview",
"description": "Intro and context for the web logs dashboard.",
"content": "## Web logs overview\n\nA quick reference for the **Kibana sample web logs** dataset (`kibana_sample_data_logs`).\n\n**Key metrics in this dashboard:**\n\n- Total request count by HTTP method\n- Average response size over time\n- Geographic distribution of client IPs\n\n> Use the time picker above to narrow the dashboard to an incident window.\n\nFor field reference, see the [sample data documentation](https://www.elastic.co/docs/manage-data/ingest/sample-data).\n",
"settings": {
"open_links_in_new_tab": true
}
}
Request example
{
"content": "## Web logs overview\n\nA quick reference for the **Kibana sample web logs** dataset (`kibana_sample_data_logs`).\n\n**Key metrics in this dashboard:**\n\n- Total request count by HTTP method\n- Average response size over time\n- Geographic distribution of client IPs\n\n> Use the time picker above to narrow the dashboard to an incident window.\n\nFor field reference, see the [sample data documentation](https://www.elastic.co/docs/manage-data/ingest/sample-data).\n",
"description": "Intro and context for the web logs dashboard.",
"settings": {
"open_links_in_new_tab": true
},
"title": "Web logs overview"
}
Response examples (201)
Response to creating a markdown library item. Returns the generated ID, the full item state in `data`, and metadata.
{
"data": {
"content": "## Web logs overview\n\nA quick reference for the **Kibana sample web logs** dataset (`kibana_sample_data_logs`).\n\n**Key metrics in this dashboard:**\n\n- Total request count by HTTP method\n- Average response size over time\n- Geographic distribution of client IPs\n\n> Use the time picker above to narrow the dashboard to an incident window.\n\nFor field reference, see the [sample data documentation](https://www.elastic.co/docs/manage-data/ingest/sample-data).\n",
"description": "Intro and context for the web logs dashboard.",
"settings": {
"open_links_in_new_tab": true
},
"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"
}
}