Praecise Platform
Menu

Rivier/ Reference/ hosting

Build a static site from an allow-listed repository

post/hosting/sites/{id}/builds

Build a static site from an allow-listed repository. The build runs in a sandbox with no network and no secrets; the result is a preview to promote.

Before you call

Credential
Authorization: Bearer $KEY
Scope
hosting:write
Mcp
rivier_hosting_build_start
Graphql
Mutation.hostingBuildStart
Sdk
hosting.build.start
Cli
hosting build start
Events
hosting.build.started

Parameters

  • idstring (uuid)required
    In the path

Request bodyapplication/json, required

  • repoobjectrequired
    • urlstringrequired
      At most 300 characters.
    • refstring
      At most 100 characters.
  • outDirstring
    At most 130 characters.
  • installboolean
  • buildboolean
  • previewboolean

Responses

  • 201application/json
    Success
    • idstring (uuid)required
    • projectIdstringrequired
    • sourceobjectrequired
      • typestringrequired
        One of: upload, repo.
      • urlstring
      • refstring
      • bundleShastring
    • outDirstringrequired
    • installbooleanrequired
    • buildbooleanrequired
    • previewbooleanrequired
    • statestringrequired
      One of: queued, running, succeeded, failed, timeout, cancelled.
    • logstringrequired
    • errorstring or nullrequired
    • deploymentIdstring or nullrequired
    • secondsnumberrequired
    • createdAtstringrequired
    • startedAtstring or nullrequired
    • finishedAtstring or nullrequired
  • 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