# List Recipes

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

List recipes the caller can access in their organization.

Each list item carries `latest_version_id` — the HEAD ULID for
the recipe on the `main` branch — so callers can pin follow-up
reads or diff against a known commit without a per-row round-trip.
Each item also carries `status` — the recipe lifecycle state, here
always `active` or `archived`, never `deleted`: a deleted recipe
never appears in a list response (see below).

Pagination is cursor-based: omit `cursor` on the first page, then
pass `meta.cursor` from each response back as `cursor` on the next
call. The cursor is self-contained — it carries forward the
`sort_by`/`order`/`status` it was issued under, so subsequent pages
don't need to resend them. Passing a param that conflicts with what
the cursor was issued under starts a fresh query at page 1 under the
new param rather than erroring. A cursor that is not a cursor at all
also starts again at page 1. A cursor that still reads as one but
whose position is not in this list (for example, one edited or
retyped) is rejected with a 400 `invalid_cursor`: pass cursors back
exactly as returned. `meta` echoes the effective
`sort_by`/`order`/`status` actually applied. Server caps `limit`
at 100.

Sort defaults to `updated_at desc` (most recently updated first).
`status` filters to `active` or `archived`, and selects a pre-built
view partition rather than filtering rows after the read — so a
filtered page here fills to `limit` whenever more matches exist.

Deleted recipes are excluded from every page regardless of filter,
and `deleted` is not an accepted `status` value: a deleted recipe is
no longer readable. This is the opposite default to
`listCustomIngredients`, which includes deleted custom ingredients in
every page because those stay readable.

Available only on API versions declaring the `recipe_versioning`
capability. Requests without this capability receive a 404.