---
title: "Change a knowledge item"
description: "Its title, the text of a note, the page of a link, its level or whether a note is pinned."
url: "https://openemail.uk/docs/api/knowledge/update"
area: "API"
category: "Mailbox"
---

# Change a knowledge item

Its title, the text of a note, the page of a link, its level or whether a note is pinned.

`PATCH /knowledge/{id}`

## PATCH /knowledge/{id}

Its title, the text of a note, the page of a link, its level or whether a note is pinned.

## Example

Needs `knowledge:write`. Give at least one of `title`, `body`, `scope`, `pinned` and `url`. A changed title, text or link is read again, and the previous text stays in use until the new one is ready. Moving an item needs reach at both levels.

**curl**

```
curl -X PATCH "$OE/knowledge/kb_8c1f4a2b9d7e3f60a5c7b21d" -H "$AUTH" \
  -H "Content-Type: application/json" -d '{ "scope": "" }'
```

**Response**

```
{
  "object": "knowledge_item",
  "id": "kb_8c1f4a2b9d7e3f60a5c7b21d",
  "kind": "note",
  "scope": "",
  "level": "workspace",
  "title": "Refunds",
  "url": null,
  "fileName": null,
  "mimeType": null,
  "sizeBytes": null,
  "pinned": true,
  "status": "ready",
  "failure": null,
  "chunks": 1,
  "chars": 71,
  "origin": "api",
  "createdBy": "usr_5f2a9c71",
  "createdAt": "2026-10-08T09:12:44.000Z",
  "updatedAt": "2026-10-08T09:12:44.000Z",
  "indexedAt": "2026-10-08T09:12:45.000Z"
}
```

> `body` or `pinned` on anything but a note is a 422 `knowledge_not_a_note`, and `url` on anything but a link a 422 `knowledge_not_a_link`.

## Reference

- [`PATCH /knowledge/{id}`](https://openemail.uk/docs/api/reference/knowledge#patch-knowledge-id): full reference