---
title: "Changes to Upsert a markdown library item"
method: PUT
path: "/api/markdowns/{id}"
---

# Changes to Upsert a markdown library item

`PUT /api/markdowns/{id}`

> Every recorded change to this endpoint, newest first.
> 176 revisions in range; 20 not diffed.

## Timeline

Changed in 1 of 176 revisions.

- **2026-08-03** `f2afbecbddc3` — 2 breaking, 4 info

## Changes

- **2026-08-03** `f2afbecbddc3` — 2 breaking, 4 info
  - the response property `data/settings` became optional for the status `200`
  - the response property `data/settings` became optional for the status `201`
  - the request property `settings` became optional
  - the `settings` request property default value `{"open_links_in_new_tab":true}` was added
  - the `settings` response's property default value `{"open_links_in_new_tab":true}` was added for the status `200`
  - the `settings` response's property default value `{"open_links_in_new_tab":true}` was added for the status `201`

---

[Operation](https://skmtc.dev/elastic/apis/kibana-apis/docs/api/markdowns/:id/put.md) · [API](https://skmtc.dev/elastic/apis/kibana-apis.md) · [Page](https://skmtc.dev/elastic/apis/kibana-apis/changes/api/markdowns/:id/put)