farfield · docs

feed

feed.farfield.systems

Ephemeral short-form posts. No titles, just a markdown body and tags. The feed is the fastest way to publish — write, tag, and ship in one step.

Screenshot of the Farfield feed UI
Feed admin stream in the logged-in state. Public reads use JSON; writes stay authenticated.

Public API

GET /api/posts
{ "posts": [Post, …] }
GET /api/posts/{slug}
Post — 404 if missing; strong ETag
GET /status
{ "service": "feed", "ok": true, "posts": N }

Write endpoints (POST /api/posts, PUT /api/posts/{slug}, DELETE /api/posts/{slug}) require an API key.

Record Shape

Post

{
  "slug": "string",
  "cid": "bafk…",
  "body": "markdown",
  "tags": ["string"],
  "createdAt": "2024-01-01T00:00:00Z",
  "updatedAt": "2024-01-01T00:00:00Z"
}