Skip to content
merran
GitHubInstall

Merran documentation API & integrations

Stop working out nutrition

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

What it worked out stays. 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.

runId
required
string

Example

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

Stopped, or stopping.

Media typeapplication/json

The latest run, going or finished in the last day.

object
id
required
string
status
required
string
Allowed values: queued running done failed cancelled
total
required
integer
done
required
integer
workedOut
required
integer
failed
required
integer
stopped
required

Why it stopped before the end, when it did.

string | null
startedAt
required
string | null format: date-time
finishedAt
required
string | null format: date-time

Example

{
"id": "0199e8b0-5a10-7a01-8b00-00000000002f",
"status": "running",
"total": 42,
"done": 12,
"workedOut": 11,
"failed": 1,
"stopped": null,
"startedAt": "2026-10-15T18:30:00.000Z",
"finishedAt": null
}

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

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

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

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

© 2026 Kyle Johnson. Documentation: CC BY 4.0. Merran: AGPL-3.0-or-later.