Merran documentation API & integrations
Change the household's theme nights
PUT
/api/households/current/themes
const url = 'http://localhost:3000/api/households/current/themes';const options = { method: 'PUT', headers: { cookie: 'merran.session_token=<merran.session_token>', 'Content-Type': 'application/json' }, body: '{"themes":[null,null,{"kind":"tag","name":"Tacos","tag":"taco"},null,null,{"kind":"fish","name":"Fish"},{"kind":"skip","name":"Eat out"}]}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}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.
Authorizations
Section titled “Authorizations”Request Bodyrequired
Section titled “Request Bodyrequired”Media typeapplication/json
object
themes
required
Dinner’s theme each weekday, Sunday first; null for none.
Array<object | null>
object
kind
required
string
name
required
string
tag
string
Example
{ "themes": [ null, null, { "kind": "tag", "name": "Tacos", "tag": "taco" }, null, null, { "kind": "fish", "name": "Fish" }, { "kind": "skip", "name": "Eat out" } ]}Responses
Section titled “Responses”Saved.
Media typeapplication/json
object
themes
required
Dinner’s theme each weekday, Sunday first; null for none.
Array<object | null>
object
kind
required
string
name
required
string
tag
string
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.