POST
/api/user_themesCreate a theme
settings is validated the same way the theme builder validates it: a value outside the vocabulary (an unrecognized token, surface, hue, or advanced channel) answers 422; a key the recipe does not read is ignored. advanced is either a mapping (channels/slots restated on one token) or the same mapping as YAML text.
- IdempotentThe SDK sends
Idempotency-Key, so a retried request is only applied once.
namestringrequired
Unique per account
settingsobjectoptional
Every key is optional; an omitted key keeps the framework default. A value outside the vocabulary (an unrecognized token, surface, hue, or advanced channel) answers 422; a key the recipe does not read is ignored, not rejected.
200Created
dataobjectoptional
401Unauthorized
errorstringoptional
422Rejects advanced YAML that does not parse
Error handling
A 401 is returned: Unauthorized. A 422 is returned: Rejects advanced YAML that does not parse.