Flambe docs
API referenceRecipes

Stream recipe change events

An append-only event log of changes to the user's recipes — the lower-level primitive behind delta sync, useful when you need to know *what* changed rather than just the current state. `since` is a numeric sequence watermark, not a timestamp. Start at `0` and carry forward the value the response returns.

GET
/api/recipes/changes

An append-only event log of changes to the user's recipes — the lower-level primitive behind delta sync, useful when you need to know what changed rather than just the current state.

since is a numeric sequence watermark, not a timestamp. Start at 0 and carry forward the value the response returns.

Authorization

bearerAuth
AuthorizationBearer <token>

A Clerk session JWT. Obtain one with a Clerk frontend SDK (session.getToken()) or, for server-to-server use, with a Clerk machine token. The token's sub claim is the Flambe user id that scopes every request.

In: header

Query Parameters

since?integer

Sequence watermark. Defaults to 0 (from the beginning).

Range0 <= value
Default0
limit?integer
Range1 <= value
Default100
cursor?string

Opaque pagination cursor returned as next_cursor by the previous page. Base64-encoded DynamoDB ExclusiveStartKey; treat it as opaque.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/recipes/changes"
{  "events": [    {      "recipe_id": "fa7d15d4-7670-4586-a94b-5079ed028135",      "type": "updated",      "seq": 0,      "at": "2019-08-24T14:15:22Z"    }  ],  "next_cursor": "string"}

Get a recipe GET

Previous Page

List recipes GET

The authenticated user's recipe library, plus any recipes shared with them through a household. Supports two independent mechanisms: - **Pagination** — `limit` (default 24, max 100) and `cursor`. - **Delta sync** — pass `updated_since` to receive only recipes changed since that instant, along with `revoked_ids` for recipes that are no longer visible. Mirror `server_timestamp` back as the next `updated_since`. Change history is retained for 30 days. A watermark older than 25 days is refused with `full_sync_required: true` and an empty result — drop your local state and re-sync without `updated_since`.