Create a project

Creates a project in the signed-in member's organization, with both of its environments. This is the first call a new customer makes: an organization has no project until somebody makes one, and every other operation on this surface acts inside one. The test and live environments are provisioned with it in a single transaction rather than asked for, so a project is never observable in a half-provisioned state. The organization comes from the verified session and is never read from the request — a member who belongs to one organization cannot create a project in another. PROJECT_LIST_LIMIT bounds how many an organization may hold, and it is the same ceiling the listing publishes: a create that would take an organization past a list it can no longer return is refused rather than silently truncating a later read. A name is unique within the organization, compared ignoring case and surrounding or repeated spaces; a second project with a name already taken is refused with state_conflict, and the refusal says nothing about any other organization's names.

post/v1/projects

Request

  • Base URL: https://docs.greatwait.dev (the document declares no server; this is the origin it was published from)
  • URL: https://docs.greatwait.dev/v1/projects
  • Auth: HTTP bearer

Request body

namestring required

Response

Create a project

createdAtstring nullable required
environmentKindsstring[] required
idstring required
namestring required
status'active' | 'archived' required
versioninteger required

Changes

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