Create a project

Atomically records the project and a durable operation for asynchronous processing.

post/v1/projects

Request

  • Base URL: https://app.ohmyho.st
  • URL: https://app.ohmyho.st/v1/projects
  • Auth: HTTP bearer

Headers

X-Request-Idstring

Optional caller-provided correlation identifier.

Idempotency-Keystring required

Identifies one mutation and its canonical request payload.

Request body

organization_idstring required
data_mode'shared' | 'isolated'

Optional at creation, default shared. shared uses one data area across Dev/Prod; isolated gives each environment its own database/Auth records and file namespace. The four Owner-confirmed data-change actions reassign or reset areas without copying data or files and without a special change fee; ordinary measured resource consumption still applies. A reset or merge removes the named Dev resources. Promotion applies pending schema migrations to isolated Prod without copying Dev data.

dev_access_mode'protected' | 'public'
region'us' | 'eu'

Chosen when the project is created and immutable afterwards. us (default) places the project's database, files, build sandbox and build objects in the US; eu places them in the EU. Prices are identical. ohmyhost.yaml storage.jurisdiction must equal this value.

namestring required

Response

The mutation was accepted for asynchronous processing.

blocking_operation_idstring
deployment_idstring
idstring required
state'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled' required
created_atstring date-time required
updated_atstring date-time required
resultobject

Changes

No recorded changes to this operation across all 1 revision of this API.