POST
Create a static site

Authorizations

Authorization
string
header
required

Bearer token for authentication. Format: 'Bearer {token}'

Headers

X-Workspace-Id
string

Workspace ID (uses default workspace if not provided)

Body

application/json

Create a static site

label
string
required

Human-readable display name

name
string
required

The name the site is served under (lowercase, alphanumeric with hyphens). Unlike applications no suffix is appended, so it must be unique across the platform

deployment_config
object
required

Content source and build configuration

project_id
string

UUID of the project to create the site in. Omit it and supply new_project_name to create one

new_project_name
string

Create a new project with this name instead of using project_id

new_project_description
string

Description for the project created via new_project_name

region
enum<string>

Region the content is stored in (defaults to 'eu-east-1'; currently the only supported region). Serving is region-less

Available options:
eu-east-1
app_vars_attributes
object[]

Build-time environment variables, exposed to the build as BUILD_VAR_*

Response

Create a static site

Api_V1_Entities_StaticSite model

uuid
string
required

Unique static site identifier

name
string
required

The name the site is served under. Unlike applications, no random suffix is appended, so it is the name you sent at creation

label
string
required

Display name

state
string
required

Current state: pending while the bucket and routing are provisioned, assigned once ready, deploying during a deploy, running when live, failed on error

url
string
required

Public URL the site is served on. Custom domains are listed separately

region
string
required

Region the content is stored in. Serving is region-less

project_id
string
required

Associated project UUID

deployment_config
object
required

Content source and build configuration. Bucket credentials are never exposed

created_at
string<date-time>
required

Creation timestamp

updated_at
string<date-time>
required

Last update timestamp