Skip to content
merran
GitHubInstall

Merran documentation API & integrations

The household's theme nights

GET
/api/households/current/themes
curl --request GET \
--url http://localhost:3000/api/households/current/themes \
--cookie merran.session_token=<merran.session_token>

Dinner’s theme each weekday, Sunday first: taco night, fish on Friday, eat out on Saturday. Fill the week keeps to them. With an API key, it needs the plan: read permission.

Its theme nights.

Media typeapplication/json
object
themes
required

Dinner’s theme each weekday, Sunday first; null for none.

Array<object | null>
object
kind
required
string
Allowed values: tag meatless fish new quick skip
name
required
string
>= 1 characters <= 30 characters
tag
string
>= 1 characters <= 40 characters

Example

{
"themes": [
null,
null,
{
"kind": "tag",
"name": "Tacos",
"tag": "taco"
},
null,
null,
{
"kind": "fish",
"name": "Fish"
},
{
"kind": "skip",
"name": "Eat out"
}
]
}

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.