Skip to content
merran
GitHubInstall

Merran documentation API & integrations

Change the household's theme nights

PUT
/api/households/current/themes
curl --request PUT \
--url http://localhost:3000/api/households/current/themes \
--header 'Content-Type: application/json' \
--cookie merran.session_token=<merran.session_token> \
--data '{ "themes": [ null, null, { "kind": "tag", "name": "Tacos", "tag": "taco" }, null, null, { "kind": "fish", "name": "Fish" }, { "kind": "skip", "name": "Eat out" } ] }'

Household admins only. Replaces the whole week.

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

Saved.

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.