One turn of designing the site by conversation

post/hosting/sites/{id}/design/turn

One turn of designing the site by conversation: describe it, answer the (at most two) questions, refine the plan, approve it to build the pages, then refine at site, page or block scope. Changes go through the patch API, so locks, undo and approval of changes to live pages hold.

Before you call

Credential: Authorization: Bearer $KEY
Scope: hosting:write
Mcp: rivier_site_design_turn
Graphql: Mutation.hostingDesignTurn
Sdk: hosting.design.turn
Cli: hosting design turn

Parameters

idstring (uuid)required
In the path

Request bodyapplication/json, required

messagestring
At most 4000 characters.
answersobject
scopeobject
approvePlanboolean
turnIdstring
At most 80 characters.
dryRunboolean

Responses

200application/json
Success
400application/json
The request was malformed
- errorstringrequired
- messagestring
401application/json
No valid credential
- errorstringrequired
- messagestring
403application/json
The credential lacks the scope, origin or address
- errorstringrequired
- messagestring
429application/json
Over the key's rate limit; see Retry-After
- errorstringrequired
- messagestring

Example request

curl -X POST 'https://api.rivier.ai/hosting/sites/{id}/design/turn' \
  -H 'Authorization: Bearer $KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "message": "string",
  "answers": {},
  "scope": {
    "kind": "site"
  },
  "approvePlan": false,
  "turnId": "string",
  "dryRun": false
}'

$KEY stands for your own key. No key is shown or kept on this site.

This page as Markdown