API reference

API reference · Account

Keep the brand kit

PUT/api/studio/brand-kitSigned in session

Replaces the kit whole. Free. Same origin only.

Request body

application/json, required

Request body fields
FieldTypeWhat it is
namerequiredstringAt most 60 characters.
coloursrequiredobject
colours.textrequiredstring
colours.accentrequiredstring
colours.groundrequiredstring
fontrequiredstringOne of "display", "body", "serif", "mono", "rounded".
cornerrequiredstringOne of "top-start", "top-end", "bottom-start", "bottom-end".
logoScalerequirednumberThe logo's width against the frame's shorter side. From 0.08 to 0.3.
endCardrequiredobject
endCard.onrequiredboolean
endCard.wordsrequiredstringAt most 80 characters.
endCard.secondsrequirednumberOne of 2, 3, 4, 5.
onrequiredbooleanPut on every export unless switched off for one.

Example

{
  "name": "string",
  "colours": {
    "text": "string",
    "accent": "string",
    "ground": "string"
  },
  "font": "display",
  "corner": "top-start",
  "logoScale": 0.08,
  "endCard": {
    "on": false,
    "words": "string",
    "seconds": 2
  },
  "on": false
}

Answer 200

The kit as kept.

Fields of the 200 answer
FieldTypeWhat it is
objectstringOne of "studio.brand_kit".
kitobject
kit.namerequiredstringAt most 60 characters.
kit.coloursrequiredobject
kit.colours.textrequiredstring
kit.colours.accentrequiredstring
kit.colours.groundrequiredstring
kit.fontrequiredstringOne of "display", "body", "serif", "mono", "rounded".
kit.cornerrequiredstringOne of "top-start", "top-end", "bottom-start", "bottom-end".
kit.logoScalerequirednumberThe logo's width against the frame's shorter side. From 0.08 to 0.3.
kit.endCardrequiredobject
kit.endCard.onrequiredboolean
kit.endCard.wordsrequiredstringAt most 80 characters.
kit.endCard.secondsrequirednumberOne of 2, 3, 4, 5.
kit.onrequiredbooleanPut on every export unless switched off for one.
savedbooleanFalse: the house's start, nothing kept yet.
logostring or nullThe logo's address, versioned by its bytes.
updated_atinteger or null

Errors

  • 400OpenAI shaped error.
  • 401OpenAI shaped error.

Every error answers in one shape, with its type, code and the field it names. The whole list is in the docs' Errors section.

Antimatter