Change the business name, brand color or market
Saves the fields supplied, with the rules of the Sorank settings page
for the same user (owner or active agency collaborator): an empty
brand_color clears it; a country the market language does not serve
falls back to the language’s default country; international clears
the country and city; city requires market_city. website_url is
read-only and any presence of it is refused with field_not_writable.
When the market changes on a site that has a business brief, its GEO
questions are regenerated asynchronously, declared as
geo_questions_regeneration_queued in effects. The response carries
the settings read after the change and the durable receipt; replaying
the same idempotency key returns the stored effects without saving or
regenerating again.
A valid request URL is required to generate request examples{
"data": {
"settings": {
"site": {
"website_url": "<string>",
"business_name": "<string>",
"brand_color": "<string>",
"market": {
"language": "<string>",
"country": "<string>",
"scope": "city",
"city": "<string>"
}
},
"business_brief": {
"status": "pending",
"revision": 1,
"document": {
"schema_version": 123,
"sections": [
{
"id": "identity",
"text": "<string>"
}
],
"offers": [
{
"id": "<string>",
"name": "<string>",
"description": "<string>"
}
]
}
},
"competitors": {
"domains": [
"<string>"
],
"max_selections": 1
},
"articles": {
"calendar_exists": true,
"timezone": "<string>",
"local_time": "<string>",
"publish_as_draft": true,
"default_instructions": "<string>",
"expert_settings": {
"tone": "<string>",
"formality": "<string>",
"generate_images": true,
"image_source_mode": "ai_only",
"image_tone": "<string>",
"image_style": "<string>",
"ethnicity": "<string>",
"image_instructions": "<string>",
"conclusion_enabled": true,
"cta_enabled": true,
"cta_title": "<string>",
"include_homepage_screenshot": true,
"include_youtube_videos": true
}
},
"visuals": {
"image_mode": "ai_only",
"covers": {
"enabled": true,
"default_preset": {
"kind": "builtin",
"key": "sketch",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}
},
"youtube": {
"connected": true,
"channel_title": "<string>",
"canonical_url": "<string>",
"enabled": true,
"sync_status": "syncing",
"last_synced_at": "2023-11-07T05:31:56Z",
"video_count": 1
}
},
"effects": [
"geo_questions_regeneration_queued"
],
"receipt": {
"operation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "accepted",
"resource_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
},
"meta": {
"request_id": "<string>",
"operation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "insufficient_quota",
"message": "The current article generation quota is exhausted.",
"request_id": "33333333-3333-4333-8333-333333333333",
"retryable": false
}
}{
"error": {
"code": "insufficient_quota",
"message": "The current article generation quota is exhausted.",
"request_id": "33333333-3333-4333-8333-333333333333",
"retryable": false
}
}Authorizations
Authorization-code grant with PKCE S256, exact scopes, explicit resource audience and a persisted consent grant. Obtain endpoint URLs from server discovery in the target environment. Refresh tokens remain client-bound.
- Authorization URL
- /oauth/authorize
- Token URL
- /oauth/token
- Refresh URL
- /oauth/token
Headers
Opaque client command key of 1 to 128 visible ASCII characters. UUID recommended; reuse only for the same command.
1 - 128^[!-~]+$Path Parameters
Profile UUID; must be in the grant allowlist and currently accessible to the actor.
Body
At least one field. website_url is not a field of this request and is refused with field_not_writable.
1Brand color; an empty string clears it.
^(#[0-9A-Fa-f]{6})?$1Market country; one the language does not serve falls back to the language default.
city, national, international A valid request URL is required to generate request examples{
"data": {
"settings": {
"site": {
"website_url": "<string>",
"business_name": "<string>",
"brand_color": "<string>",
"market": {
"language": "<string>",
"country": "<string>",
"scope": "city",
"city": "<string>"
}
},
"business_brief": {
"status": "pending",
"revision": 1,
"document": {
"schema_version": 123,
"sections": [
{
"id": "identity",
"text": "<string>"
}
],
"offers": [
{
"id": "<string>",
"name": "<string>",
"description": "<string>"
}
]
}
},
"competitors": {
"domains": [
"<string>"
],
"max_selections": 1
},
"articles": {
"calendar_exists": true,
"timezone": "<string>",
"local_time": "<string>",
"publish_as_draft": true,
"default_instructions": "<string>",
"expert_settings": {
"tone": "<string>",
"formality": "<string>",
"generate_images": true,
"image_source_mode": "ai_only",
"image_tone": "<string>",
"image_style": "<string>",
"ethnicity": "<string>",
"image_instructions": "<string>",
"conclusion_enabled": true,
"cta_enabled": true,
"cta_title": "<string>",
"include_homepage_screenshot": true,
"include_youtube_videos": true
}
},
"visuals": {
"image_mode": "ai_only",
"covers": {
"enabled": true,
"default_preset": {
"kind": "builtin",
"key": "sketch",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}
},
"youtube": {
"connected": true,
"channel_title": "<string>",
"canonical_url": "<string>",
"enabled": true,
"sync_status": "syncing",
"last_synced_at": "2023-11-07T05:31:56Z",
"video_count": 1
}
},
"effects": [
"geo_questions_regeneration_queued"
],
"receipt": {
"operation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "accepted",
"resource_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
},
"meta": {
"request_id": "<string>",
"operation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "insufficient_quota",
"message": "The current article generation quota is exhausted.",
"request_id": "33333333-3333-4333-8333-333333333333",
"retryable": false
}
}{
"error": {
"code": "insufficient_quota",
"message": "The current article generation quota is exhausted.",
"request_id": "33333333-3333-4333-8333-333333333333",
"retryable": false
}
}