Publish a project written in Syntext as it is now.
POST/v1/projects/{projectId}/content/publishTry it
API key or session token
Build and deploy a project written in Syntext from its latest revision. Saves are drafts until you publish — this is the editor's Publish button.
Note
Any workspace member (session JWT), or an API key bound to this project with the build scope or higher. Each publish is a build, so it counts toward the workspace's monthly build quota.
Path Parameters
NameDescription
projectId:stringpathRequired
The project ID.
Request Body
NameDescription
message:stringbody
A note for the build, up to 500 characters.
Response — 202 Accepted
build is the queued build — follow it with Get Build. When it deploys, the revision counts as published and GET /content shows unpublishedChanges: false. A failed build leaves the site as it was.
To save and publish in one call, send publish: true with Save Pages instead.
Error Responses
402 Payment Required
USAGE_LIMIT_EXCEEDED — the workspace's builds for the month are used up. Your drafts are kept; publish again when the plan renews or after upgrading.
json
{
"error": {
"code": "USAGE_LIMIT_EXCEEDED",
"message": "Monthly build limit reached (100/100). Upgrade your plan for more builds.",
"current": 100,
"limit": 100
}
}
409 Conflict
•
nothing_to_publish — the project has no pages yet.