Create a new documentation project in your organization.
Request Body
nameorgId403 forbidden. When omitted, the project goes into the first organization you belong to.sluga-z, 0-9 and -. Auto-generated from name if not provided. Used in the docs URL: {slug}-docs.syntext.dev. Check a slug first with Check Subdomain Availability.descriptionrepoUrlhttps://github.com/acme/docs.repoBranchmain."main"contentSourcehosted (written in Syntext), github (the repository in repoUrl) or upload (published with stx deploy). Defaults to github with a repoUrl and hosted without one. A repoUrl with any other source returns 400 validation_error. See Write and publish without GitHub.templateA starter for a project written in Syntext: help-center, product-guides, handbook, developer-docs or blank. List them with List Templates. Sending contentSource: "hosted" without a template uses blank. With any other source, a template returns 400 validation_error.
The template's pages are saved as revision 1 and published straight away, so the site is live at once. Sending neither contentSource nor template without a repoUrl creates an empty project written in Syntext, with no build.
isPublic400. This is a stored flag only — it does not restrict who can read the doc site. To gate the site, use access control or audience gating.trueSettings (branding, site password, AI persona) are not accepted here. Set them with Update Project once the project exists.
Response
Returns 201 with the created project object — see Get Project. When a template was used, it also has:
template — the template's id.revision — { id, number } of the template's first revision.initialBuild — { id, status } of the publish, or null when it couldn't start.publishError — { code, message } when the publish couldn't start, for example USAGE_LIMIT_EXCEEDED when the plan's builds are used up. The project and its pages exist either way; publish later with Publish Content.Error Responses
400 Bad Request
validation_error — required fields are missing or have invalid values. details.issues lists each problem — see Validation errors:
400 bad_request ("No organization found. Create one first.") is returned when you omit orgId and belong to no organization.
409 Conflict
Returned when a project with this slug already exists.
402 Payment Required
Returned when the organization already has as many projects as its plan allows. The code is USAGE_LIMIT_EXCEEDED, as for other usage limits.
403 Forbidden
Returned when orgId names an organization you are not a member of.