Jatobá
API Reference

Public Acervo

A tenant's public archive feed of published documents

GET /api/public/acervo

Lists a tenant's published documents — built for public archive/marketing sites. Authorized by a per-tenant acervo token sent as Bearer (the token names the tenant and grants the read; no Clerk session). Only published, non-deleted documents are returned, newest first. Cacheable for 5 minutes, 60 req/min.

Query paramTypeDescription
limitinteger1–60, default 60
offsetintegerDefault 0
curl -H "Authorization: Bearer $JATOBA_ACERVO_TOKEN" \
  "https://jatoba-web3-production.up.railway.app/api/public/acervo?limit=20&offset=0"

200

{
  "documents": [
    {
      "serialNumber": "JAT-7K2M9",
      "title": "Ata da assembleia",
      "author": "Liga Colaborativa",
      "metadata": "2026 · PDF",
      "publishedAt": "2026-05-01T12:00:00.000Z"
    }
  ],
  "total": 42
}

401 — missing or invalid acervo token.

Manage the token via Settings: generate/rotate with POST /api/settings/acervo-token, disable with DELETE. Publish documents to the feed with PATCH /api/documents/:id/publish.

On this page