Skip to content
merran
GitHubInstall

Merran documentation API & integrations

Buy something every week

POST
/api/list/every-week
curl --request POST \
--url http://localhost:3000/api/list/every-week \
--header 'Content-Type: application/json' \
--cookie merran.session_token=<merran.session_token> \
--data '{ "name": "Bananas", "amount": "1 bunch" }'

With an API key, it needs the list: write permission.

Media typeapplication/json
object
name
required
string
>= 1 characters <= 200 characters
amount
string | null
<= 60 characters

Example

{
"name": "Bananas",
"amount": "1 bunch"
}

Bought every week now.

Media typeapplication/json
object
id
required
string
name
required
string
amount
required
string | null
aisle
required
string | null

Example

{
"id": "0199e8b0-5a10-7a01-8b00-000000000023",
"name": "Bananas",
"amount": "1 bunch",
"aisle": "0199e8b0-5a10-7a01-8b00-000000000020"
}

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

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