Skip to main content
PATCH
/
v1
/
checkouts
/
builder
/
settings
curl --request PATCH \
  --url https://api.y.uno/v1/checkouts/builder/settings \
  --header 'Content-Type: application/json' \
  --header 'PRIVATE-SECRET-KEY: <api-key>' \
  --header 'PUBLIC-API-KEY: <api-key>' \
  --header 'X-Account-Code: <api-key>' \
  --data '
{
  "styles": {
    "global": {
      "accent_color": "#1A73E8"
    }
  }
}
'
{
  "updated_at": "2026-05-18T14:00:00Z"
}
This API is in Beta. Endpoints and schemas may change without prior notice.

Authorizations

​
PUBLIC-API-KEY
string
header
required

Merchant public API key. Found in Yuno dashboard → Settings → API Keys.

​
PRIVATE-SECRET-KEY
string
header
required

Merchant private secret key, paired with the public key. Never embed in client-side code.

​
X-Account-Code
string
header
required

UUID of the merchant account scope for the request.

Headers

​
X-Idempotency-Key
string

Client-generated UUID. Re-sending the same request with the same key is safe and will not double-publish.

Body

application/json
​
styles
object

Visual styles for the checkout SDK. Send {} to leave unchanged.

​
settings
object

SDK behavior and UI options. Send {} to leave unchanged.

​
payment_link_styles
object

Visual styles for the hosted Payment Link page. Independent from styles — does not inherit from it.

​
flags
object

Feature flags.

​
external_fonts
object[]

Font families available to the SDK. The default catalog includes 18 Yuno-hosted families (17 are constant; the 18th varies by account — run a GET to confirm the full list for your account). Custom entries can be added; they must be HTTPS and CORS-enabled.

Response

200

​
updated_at
string

Timestamp of the update.

Example:

"2026-05-18T14:00:00Z"