POST/api/user_themes

Create 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.

2 body fields
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.

3 status codes
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.