Personal API

Search

Find pages by title and text inside a vault.

View as plain text Map for AI agents (JSON)

GET /vaults/{vault}/search?q={text}

Searches the title and text of the vault's pages. Returns up to 50 results. The search text can be up to 100 characters.

curl "https://wire.ia.br/api/v1/vaults/principal/search?q=budget" \
  -H "Authorization: Bearer $PAPER_TOKEN" \
  -H "X-Paper-Account: $PAPER_ACCOUNT"

Response with a regular token

The search runs in the person's Google Drive and returns the pages it found:

[
  { "id": "pa1k2m3n4o5p", "title": "Monday meeting", "kind": "pagina", "updatedAt": "2026-10-01T14:03:11.000Z" }
]

To read the text, request the page with GET /vaults/{vault}/pages/{id}.

Response with a secure token

In the copy for AI, each result already comes with a snippet around what was found:

[
  { "id": "pa1k2m3n4o5p", "title": "Monday meeting", "trecho": "…review the budget before the meeting with…" }
]

Tips

Encode the text in the URL (encodeURIComponent in JavaScript, urllib.parse.quote in Python).
To scan the whole vault, list the pages once and keep the result. Don't run one search per page.
Protected pages never show their content. With the "Show only the title" permission, they may appear in the results by title.

Vaults and pages

List vaults, list and read pages, create, edit and send to the trash.

Attachments

Upload images and files that are part of the notes.

On this page

Response with a regular token Response with a secure token Tips