Skip to main content
POST
Create account project

Authorizations

Authorization
string
header
required

Use a JWT bearer token or a Veryfront API key in the Authorization header.

Path Parameters

account_id
string<uuid>
required

Account to receive the new project. Project creation and account assignment are atomic. Requires account.projects.create. The caller remains the billing and seat owner. The caller project limit returns 402 when exhausted.

Body

application/json
name
string
required

Project display name.

Minimum string length: 1
slug
string

Unique project slug. Omit to generate a slug with a random suffix. An explicit duplicate slug returns 409; creation does not replay an existing project.

Minimum string length: 1
Pattern: ^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$
template_slug
string

Optional template slug. A template project UUID takes precedence.

template_project_id
string<uuid>

Optional template project UUID. Overrides template_slug.

Response

Project created

id
string<uuid>
required

Project UUID.

slug
string
required

Project slug.

name
string
required

Project display name.

account_id
string<uuid>
required

Account UUID to which this project is assigned.

type
enum<string>
required

Project classification: regular, default, or template.

Available options:
regular,
default,
template
is_template
boolean
required

Whether the project is available as a template.

system_managed
boolean
required

Whether the platform manages this project.

created_at
string
required

Project creation timestamp in ISO 8601 UTC.

updated_at
string
required

Project last-update timestamp in ISO 8601 UTC.