Developers
Feed API
Read items with a tenant pf_ key. Spec is OpenAPI, not this page.
Public read API for apps and sites. Issue a key under Developer → API & MCP. Console session cookies are not used here. Creating sources and workflows stays in the console — there is no public POST /automations.
Auth
| Header | Value |
|---|---|
| Authorization | Bearer pf_… (shown once at create) |
| X-API-Key | Same pf_ secret (alternative to Bearer) |
When the API is in required-auth mode, every /v1/feed/* call needs a key. /healthz, /readyz, and /openapi.json stay open.
List items
GET /v1/feed/items
| Query | Required | Notes |
|---|---|---|
| tenant_id | Yes | Workspace UUID. |
| language_code | Yes | Display language, e.g. en. |
| category | No | Same string you set on the source (e.g. top-stories). |
| limit | No | Default 20, max 50. |
| cursor | No | Opaque cursor from the previous page. |
| include_untranslated | No | Boolean. List default false. |
| all_source_languages | No | Boolean. Include items regardless of source language. |
Example
curl -sS -H "Authorization: Bearer pf_YOUR_KEY" \ "https://YOUR_HOST/v1/feed/items?tenant_id=TENANT_UUID&language_code=en&category=top-stories&limit=20"
Other routes
| Method | Path | Notes |
|---|---|---|
| GET | /v1/feed/items/{item_id} | tenant_id required; language_code required; include_untranslated default true. |
| GET | /v1/feed/languages | tenant_id required. Languages enabled for the workspace. |
| POST | /v1/feed/items/{item_id}/love | Increment love count. |
| GET | /openapi.json | Machine-readable spec. Do not copy fields into a second doc — this is the contract. |
On the public edge, /v1/* and /openapi.json proxy to the API. Replace YOUR_HOST with your Aevico or tenant API host.
32 articles on this site. Engineering notes on GitHub.