Skip to content
merran
GitHubInstall

Merran documentation API & integrations

Say names a line was joined from aren't the same

POST
/api/list/items/{itemId}/apart
curl --request POST \
--url http://localhost:3000/api/list/items/0199e8b0-5a10-7a01-8b00-00000000001d/apart \
--header 'Content-Type: application/json' \
--cookie merran.session_token=<merran.session_token> \
--data '{ "names": [ "unsalted butter" ] }'

Each name is its own food for the household from the next list on (docs/foods.md). The line as it is stays. With an API key, it needs the list: write permission.

itemId
required
string

Example

0199e8b0-5a10-7a01-8b00-00000000001d
Media typeapplication/json
object
names
required
Array<string>
>= 1 items <= 50 items

Example

{
"names": [
"unsalted butter"
]
}

Remembered.

Media typeapplication/json
object
kept
required
integer

Example

{
"kept": 1
}

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.