Skip to main content
POST
Error

Authorizations

Authorization
string
header
required

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.

FlowAuthorization Code
Authorization URL
/oauth/authorize
Token URL
/oauth/token
Refresh URL
/oauth/token
Scopes3
calendar:write
Manage calendar and slots.
articles:generate
Generate articles.
articles:publish
Schedule and manage CMS publication.

Headers

Idempotency-Key
string
required

Opaque client command key of 1 to 128 visible ASCII characters. UUID recommended; reuse only for the same command.

Required string length: 1 - 128
Pattern: ^[!-~]+$

Path Parameters

profile_id
string<uuid>
required

Profile UUID; must be in the grant allowlist and currently accessible to the actor.

Body

application/json
replace_slot_ids
string<uuid>[]
required
Required array length: 1 - 100 elements
settings
object
required
start_date
string<date>
required

Local start date; the selected local_time must be in the future and the planner starts here.

end_date
string<date>
required

Inclusive local end date; the command rolls back if any planned slot falls later.

keyword_ids
string<uuid>[]
required
Required array length: 1 - 100 elements
subjects
object[]
Required array length: 1 - 100 elements

Response

Calendar state, warnings and durable receipt.

data
object
required
meta
object
required