Rivier/ Reference/ hosting

Create a page at a path, optionally with its block tree

post/hosting/sites/{id}/pages

Before you call

Credential
Authorization: Bearer $KEY
Scope
hosting:write
Mcp
rivier_site_page_create
Graphql
Mutation.hostingSitePageCreate
Sdk
hosting.sitePage.create
Cli
hosting site page create

Parameters

  • idstring (uuid)required
    In the path

Request bodyapplication/json, required

  • projectobject
    • coverobject or null
    • summarystring
      Default: . At most 300 characters.
    • yearinteger or null
    • clientstring
      Default: . At most 120 characters.
    • roleslist of string
      Default: [].
    • tagslist of string
      Default: [].
    • linkslist of object
      Default: [].
      • labelstringrequired
        At most 60 characters.
      • urlstring (uri)required
        At most 300 characters.
    • visibilitystring
      One of: draft, public, unlisted, expiring, password.
    • expiresAtstring or null
    • orderinteger or null
    • featuredboolean
    • rightsobject or null
    • passwordstring
      At most 128 characters.
  • pathstringrequired
    At most 120 characters.
  • titlestringrequired
    At most 200 characters.
  • localestring
    At most 20 characters.
  • groupstring or null
  • seoobject
  • treelist of object
    The page content as a list of blocks.
  • blockslist of object
    An alias of tree, accepted for callers that name the list blocks. Send one of the two.

Responses

  • 201application/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

    This page as Markdown