Recently deleted

GET

/api/recipes/deleted

curl --request GET \
  --url http://localhost:3000/api/recipes/deleted \
  --cookie merran.session_token=<merran.session_token>

• Your Merran

Deleted recipes, which can be put back for 30 days, latest first. With an API key, it needs the recipes: read permission.

Authorizations

• session
• apiKey

Responses

200

What’s there.

Media typeapplication/json

Array

object

id

required

string

slug

required

string

name

required

string

description

required

string | null

servings

required

number | null

totalMinutes

required

As given, or prep and cook added up.

number | null

rating

required

number | null

tags

required

Array<string>

diets

required

Diet labels worked out from the ingredients, with the household’s corrections.

Array<string>

Allowed values: vegetarian vegan gluten-free dairy-free egg-free nut-free

photo

required

Where its photo is, in each size, or null. The links change with the photo, so they can be kept.

object

full

required

For the recipe page.

string

card

required

Cropped, for recipe cards.

string

lastMadeAt

required

string | null format: date-time

createdAt

required

string format: date-time

updatedAt

required

string format: date-time

deletedAt

required

string format: date-time

goneAt

required

When it’s deleted for good.

string format: date-time

Example

[
  {
    "id": "0199e8b0-5a10-7a01-8b00-000000000006",
    "slug": "lemon-chicken",
    "name": "Lemon Chicken",
    "description": "Crisp chicken thighs roasted with lemon, garlic and thyme.",
    "servings": 4,
    "totalMinutes": 50,
    "rating": 5,
    "tags": [
      "chicken",
      "dinner"
    ],
    "diets": [
      "gluten-free",
      "dairy-free",
      "egg-free",
      "nut-free"
    ],
    "photo": {
      "full": "/api/recipes/0199e8b0-5a10-7a01-8b00-000000000006/photo?size=full&v=4b1c2d3e",
      "card": "/api/recipes/0199e8b0-5a10-7a01-8b00-000000000006/photo?size=card&v=4b1c2d3e"
    },
    "lastMadeAt": "2026-10-09T01:15:00.000Z",
    "createdAt": "2026-10-01T17:30:00.000Z",
    "updatedAt": "2026-10-15T18:30:00.000Z",
    "deletedAt": "2026-10-15T18:30:00.000Z",
    "goneAt": "2026-11-14T18:30:00.000Z"
  }
]

401

Not signed in.

Media typeapplication/json

object

error

required

object

code

required

string

message

required

string

fields

object

key

additional properties

string

Example

{
  "error": {
    "code": "not_found",
    "message": "There's nothing here.",
    "fields": {
      "name": "Give it a name."
    }
  }
}

403

Not allowed.

Media typeapplication/json

object

error

required

object

code

required

string

message

required

string

fields

object

key

additional properties

string

Example

{
  "error": {
    "code": "not_found",
    "message": "There's nothing here.",
    "fields": {
      "name": "Give it a name."
    }
  }
}