Rivier/ Reference/ hosting

Create a site with a generated address under the platform domain

post/hosting/sites

Before you call

Credential
Authorization: Bearer $KEY
Scope
hosting:write
Mcp
rivier_hosting_site_create
Graphql
Mutation.hostingSiteCreate
Sdk
hosting.site.create
Cli
hosting site create
Events
hosting.site.created

Request bodyapplication/json, required

  • namestringrequired
    At most 120 characters.
  • slugstringrequired
    At most 16 characters.
  • tierstringrequired
    One of: static, next.
  • regionstring
    At most 24 characters.

Responses

  • 201application/json
    Success
    • idstring (uuid)required
    • slugstringrequired
    • namestringrequired
    • tierstringrequired
      One of: static, next.
    • statestringrequired
    • hoststringrequired
    • productionDeploymentIdstring (uuid) or nullrequired
    • retainedUntilstring or nullrequired
    • regionstring
    • createdAtstringrequired
    • updatedAtstringrequired
  • 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