Change the calendar article defaults
Saves the calendar article defaults with the rules of the Sorank calendar
settings for the same user, through the same command as
update_calendar_settings (which keeps calendar:write): timezone,
local_time (HH:MM), publish_as_draft, default_instructions and
expert_settings. expert_settings is the complete set of calendar-wide
defaults, as get_settings returns it: it replaces the current one and an
empty object clears it. tone, image_tone, image_style and
formality are validated against their enums (the Sorank settings pages
use the same server validation); ethnicity is free text. The defaults
are stored on the calendar: without one the request is refused with
calendar_required. A timezone or time change moves the scheduled slots
to keep their local time, declared as calendar_slots_shifted in
effects; a change that would leave slots outside the scheduling horizon
is refused with calendar_horizon_exceeded.
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.
IANA timezone such as Europe/Paris.
1Local wall-clock publication time HH:MM.
^([01][0-9]|2[0-3]):[0-5][0-9]$true sends generated articles to the CMS as drafts.
Default editorial instructions; an empty string clears them.
Complete calendar-wide article defaults; they replace the current ones and an empty object clears them. An absent field inherits the system default.
Show child attributes
Show child attributes
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
}
}