Skip to content
Skip to Content
Docs
Studio

List Custom Ingredient Versions

List a custom ingredient's version history, newest first (cursor-paginated, max 50 per page).

Each entry includes version_id, parent_version_id, created_at, created_by (with created_by_name and created_by_former_member naming that actor), and an auto-generated summary of what changed. For actor/event audit narrative, use GET /custom-ingredients/\{custom_ingredient_id\}/audit-trail instead.

GET
/studio/custom-ingredients/{custom_ingredient_id}/versions

Path Parameters

custom_ingredient_id*Custom Ingredient Id

Query Parameters

after?|

Opaque pagination cursor returned in meta.cursor from a previous response. Omit on the first page; pass the previous response's meta.cursor verbatim on each subsequent page.

limit?Limit

Maximum entries to return per page (1 to 50).

Range1 <= value <= 50
Default50

Response Body

Successful Response

application/json
  1. response

Paginated list of versions for a single custom ingredient, newest first.

Pagination uses an opaque cursor passed back as ?after=<cursor>. Versions are ordered by creation time. limit is capped server-side at 50.

data*array<>

Version summaries for this page, ordered newest-first. Empty when the custom ingredient has no versions.

meta*

Pagination metadata. meta.cursor is null when there are no further pages; otherwise pass it back as the after query parameter to fetch the next page.

Example Request
curl -X GET 'https://api.bettermenu.live/studio/custom-ingredients/string/versions'
Example Response
{  "data": [    {      "version_id": "string",      "parent_version_id": "string",      "created_at": "2019-08-24T14:15:22Z",      "created_by": "string",      "created_by_name": "string",      "created_by_former_member": false,      "created_by_is_viewer": false,      "summary": "string",      "restored_from_version_id": "string",      "caused_by_event_id": "string",      "version_number": 0    }  ],  "meta": {    "version": "string",    "request_id": "string",    "timestamp": "string",    "cursor": "string",    "has_more": true  }}

Recipe in, FDA-format Nutrition Facts out, with every version kept.

Start freeNo card needed.