Merran documentation API & integrations
Say something on the list is the same food as another
POST
/api/list/items/{itemId}/same-as
const url = 'http://localhost:3000/api/list/items/0199e8b0-5a10-7a01-8b00-00000000001d/same-as';const options = { method: 'POST', headers: { cookie: 'merran.session_token=<merran.session_token>', 'Content-Type': 'application/json' }, body: '{"item":"0199e8b0-5a10-7a01-8b00-00000000001e"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url http://localhost:3000/api/list/items/0199e8b0-5a10-7a01-8b00-00000000001d/same-as \ --header 'Content-Type: application/json' \ --cookie merran.session_token=<merran.session_token> \ --data '{ "item": "0199e8b0-5a10-7a01-8b00-00000000001e" }'The household’s own name for the food (docs/foods.md): from now on it’s the other’s food, on the list, at home and in what’s to come, and the two lines join where their amounts add up. With an API key, it needs the list: write permission.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”itemId
required
string
Example
0199e8b0-5a10-7a01-8b00-00000000001dRequest Bodyrequired
Section titled “Request Bodyrequired”Media typeapplication/json
object
item
required
The other thing on the list it’s the same food as.
string
Example
0199e8b0-5a10-7a01-8b00-00000000001eExample
{ "item": "0199e8b0-5a10-7a01-8b00-00000000001e"}Responses
Section titled “Responses”Remembered, and joined.
Media typeapplication/json
object
food
required
The food both are now, for the household.
string
joined
required
How many lines joined into others.
integer
Example
{ "food": "butter", "joined": 1}The same thing twice.
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 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." } }}Not on the list.
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.