---
title: "Refresh the intelligence documents"
description: "Recompile every document now from what this workspace already stores.\n\nThe compiler runs no model, so a refresh is free, deterministic and repeatable: identical inputs write no new version, and `changed` says which documents actually moved.\n\nFree, and there is no quote. There is no schedule in this version — you refresh when you want it refreshed."
url: https://docs.roasos.com/api-reference/intelligence/refreshIntelligence
---

# Refresh the intelligence documents

Recompile every document now from what this workspace already stores.

The compiler runs no model, so a refresh is free, deterministic and repeatable: identical inputs write no new version, and `changed` says which documents actually moved.

Free, and there is no quote. There is no schedule in this version — you refresh when you want it refreshed.

## `POST /v1/intelligence/refresh`

Endpoint: `POST https://api.roasos.com/v1/intelligence/refresh`

Refresh the intelligence documents

Recompile every document now from what this workspace already stores.

The compiler runs no model, so a refresh is free, deterministic and repeatable: identical inputs write no new version, and `changed` says which documents actually moved.

Free, and there is no quote. There is no schedule in this version — you refresh when you want it refreshed.

### Responses

- `200`: What the recompile wrote
- `501`: not_implemented: the intelligence API is contracted and not live yet
- `503`: The documents could not be recompiled

Read the full reference at https://docs.roasos.com/api-reference/intelligence/refreshIntelligence.