Stop a tidy up run

POST

/api/recipes/tidy/{runId}/stop

curl --request POST \
  --url http://localhost:3000/api/recipes/tidy/0199e8b0-5a10-7a01-8b00-00000000002a/stop \
  --cookie merran.session_token=<merran.session_token>

• Your Merran

The suggestions it made stay in Review. The recipe it’s on finishes first, so the answer may still say it’s running. With an API key, it needs the recipes: write permission.

Authorizations

• session
• apiKey

Parameters

Path Parameters

runId

required

string

Example

0199e8b0-5a10-7a01-8b00-00000000002a

Responses

200

Stopped, or stopping.

Media typeapplication/json

object

id

required

string

status

required

string

Allowed values: queued running done failed cancelled

library

required

Every recipe not tidied yet, rather than ones picked.

boolean

total

required

number

done

required

number

suggested

required

Recipes with suggestions waiting in Review.

number

fine

required

Recipes with nothing to change.

number

failed

required

number

stopped

required

Why it stopped before the end, when it did: no AI, this month’s limit, no credit, or three failures in a row.

string | null

startedAt

required

string | null format: date-time

finishedAt

required

string | null format: date-time

Example

{
  "id": "0199e8b0-5a10-7a01-8b00-00000000002a",
  "status": "running",
  "library": true,
  "total": 52,
  "done": 12,
  "suggested": 9,
  "fine": 3,
  "failed": 0,
  "stopped": null,
  "startedAt": "2026-10-01T17:30:00.000Z",
  "finishedAt": null
}

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."
    }
  }
}

404

No such run in this household.

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."
    }
  }
}

409

It has already finished.

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."
    }
  }
}