Resources
Add texts, files, web pages and websites, follow their import status, re-index them and stay within your plan's word allowance.
A resource is a piece of knowledge, stored once and reusable by any assistant. Open Resources in the app to see them all, filter by type, tag or status, and open one to edit it.
Add a resource
Choose Add a resource, then pick a tab: Text, Files, Web page or Sitemap (a whole website).
| You add | What happens | Guide |
|---|---|---|
| Text tab | Lookio indexes what you paste. | Below |
| Files tab | Each file becomes a resource, read by the right tool for its format. | File formats |
| Web page tab | Each address becomes a resource, read as a visitor sees it. | Websites |
| Sitemap tab | One resource whose pages are read and kept in sync. | Websites |
Text
Paste text or Markdown, up to 100,000 characters. Lines starting with # become the sections that answers cite, so give a long text real headings.
The title is part of every passage Lookio indexes. Write a descriptive one: “Refund policy 2026” retrieves better than “Notes”.
Fields on every resource
- Title. Up to 200 characters.
- Tags. Up to 30, each up to 60 characters. See Tags.
- Source. Optional, up to 500 characters. A URL or a mention such as “Employee handbook, 2026 edition”. It is shown with every citation of the resource. An empty value clears it. See Citations.
Statuses
Every import is asynchronous. The resource is created at once with a status, and Lookio reads and indexes it in the background: seconds for a page or a short file, minutes for a site.
| Status in the API | Shown in the app | Meaning |
|---|---|---|
queued | Indexing | Waiting to be read. |
processing | Indexing | Being read and indexed. |
ready | Ready | Searchable. Assistants can answer from it. |
failed | Failed | Could not be read. status_detail says why. |
stale | Needs re-indexing | Out of date. Re-index it. |
ready and failed are final. Poll until one of them appears and stop there.
An assistant answers only from ready resources. A resource that is still queued is skipped without an error, so a question asked too early can come back with no answer.
On a development deployment without the live engine, a resource shows ready_simulated. You only meet this status when you run Lookio locally.
Re-index
Open a resource and choose Re-index. What it does depends on the type, and the action is named after it.
| Type | Re-index |
|---|---|
| Text | Indexes the current text again. |
| File | Reads the stored original again. Nothing is uploaded twice. |
| Web page | Fetches the page again. The action is called Re-read page. |
| Website | Synchronises the site: new pages are added, changed pages are read again and pages that are gone are removed. The action is called Sync now. |
Re-indexing costs no credits. While a new version is being built, the resource stays searchable on its current version, and the new one replaces it only when it is complete.
Editing a text, or renaming a file, re-indexes it for the same reason: the title is part of every passage.
Use re-index after a failure, or when the source changed. For a website that syncs weekly you rarely need it.
Read what was indexed
Open a resource to see its extracted text, exactly as assistants search it, in Markdown. It also lists what Lookio could not read, such as pages without readable text. Check an import this way before you rely on it. The text is shown up to 200,000 characters.
Word allowance
Your plan caps the number of words Lookio stores for the workspace.
| Plan | Words stored |
|---|---|
| Free | 125,000 |
| Starter | 1,000,000 |
| Pro | 10,000,000 |
| Custom | No fixed limit |
Lookio counts the words of every ready resource, as runs of letters or digits. When the limit is reached, adding or re-indexing is refused with this message: “Your plan’s limit of 125,000 words stored is reached. Delete resources or upgrade your plan to add more.” The API error code is request_too_large_for_plan.
A resource that would pass the limit while it is being indexed fails with the same message in status_detail. Delete resources you no longer need, or change plan. See Credits and plans.
From the API, the CLI and MCP
Everything on this page is available outside the app.
- API: List resources, Create a resource, Add a file.
- CLI:
lookio resources, see Commands. - MCP:
add_text_resource,add_web_page,get_resource, see Tools.