---
title: "Read a knowledge item again"
description: "Fetches a link again, reads a file again or indexes a note again."
url: "https://openemail.uk/docs/api/knowledge/refresh"
area: "API"
category: "Mailbox"
---

# Read a knowledge item again

Fetches a link again, reads a file again or indexes a note again.

`POST /knowledge/{id}/refresh`

## POST /knowledge/{id}/refresh

Fetches a link again, reads a file again or indexes a note again.

## Example

Needs `knowledge:write`. It clears a failure and puts the item back at `queued`. The previous text stays in use until the new one is ready.

**curl**

```
curl -X POST "$OE/knowledge/kb_3e7b1d9a4c2f80e6b5a1c47d/refresh" -H "$AUTH"
```

**Response**

```
{
  "object": "knowledge_item",
  "id": "kb_3e7b1d9a4c2f80e6b5a1c47d",
  "kind": "link",
  "scope": "",
  "level": "workspace",
  "title": "https://acme.com/shipping",
  "url": "https://acme.com/shipping",
  "fileName": null,
  "mimeType": null,
  "sizeBytes": null,
  "pinned": false,
  "status": "queued",
  "failure": null,
  "chunks": 0,
  "chars": 0,
  "origin": "api",
  "createdBy": "usr_5f2a9c71",
  "createdAt": "2026-10-08T09:14:02.000Z",
  "updatedAt": "2026-10-08T09:14:02.000Z",
  "indexedAt": null
}
```

> Reading an item again twice leaves it the same way, so a retry is safe.

## Reference

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