Skip to main content
POST
Create

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

orgId
string
required

The organization's id (UUID) or slug — either form is accepted.

Body

application/json
name
string
required
slug
string
required

Managed subdomain label — globally unique.

Pattern: ^[a-z][a-z0-9-]{1,61}$
runtimeClass
enum<string>
required
Available options:
scale-to-zero,
always-on
region
string

Compute region id for always-on apps (see regions.list); defaults to the platform default region. Scale-to-zero apps run on the global edge and must not pick a region. Immutable after creation.

gitRepo
string

Repository to connect as "owner/repo" — enables push-to-deploy and pull-request previews.

Pattern: ^[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+$
gitRef
string

Production branch for push-to-deploy. Defaults to main.

Response

Project created.

id
string
required
name
string
required
slug
string
required
Pattern: ^[a-z][a-z0-9-]{1,61}$
runtimeClass
enum<string>
required
Available options:
scale-to-zero,
always-on
region
string
required

Where the app runs: a compute region id for always-on apps, "global" for scale-to-zero apps (they run on the global edge). Immutable after creation. The catalog lives at regions.list.

gitRepo
string | null
required

Connected repository as "owner/repo" — pushes and pull requests there drive deploys and previews; null when no repository is connected.

gitRef
string
required

Production branch — pushes to it deploy automatically.

url
string
required

Public URL on the managed domain ("https://.korve.app").

createdAt
string<date-time>