Get branding settings
GET /v1/org/branding
Returns the current branding configuration for your organization, including the maximum retention period allowed by your plan.
Response
string | null
URL of your organization’s logo.
null if not set.string | null
Hex color code for your organization’s accent color.
null if not set.integer
default:"30"
Number of days session data is retained. Defaults to
30.integer
Maximum retention days allowed by your current plan. Varies by plan:
30 for Starter, 90 for Growth, 365 for Business.string
Your organization’s current plan (
starter, growth, business, or none).Update branding settings
PUT /v1/org/branding
Updates your organization’s branding configuration. Requires an active subscription. All fields are optional — only provided fields are updated.
Request body
string | null
URL of your organization’s logo. Pass
null to remove.string | null
Hex color code for your accent color. Pass
null to remove.integer
Number of days to retain session data. Cannot exceed
maxRetentionDays for your plan.200— Settings updated. Returns the updated branding object (same shape as the GET response).400— Invalid request body, orretentionDaysexceeds the plan limit. Error message includes the maximum allowed value.402— Subscription inactive or trial expired.
