Save App Version
POST/apps/{appIdOrSlug}/versions/save
Creates a new saved version from the app's current draft. If no name is provided, one is auto-generated. The draft must exist before calling this endpoint.
Path Parameters
The app's UUID or slug.
Request Body
Name for the version. Max 25 characters; cannot contain spaces or the special characters ~^:?*[]\@{. If omitted, a name is auto-generated.
Error Responses
Version name contains disallowed characters or fails git ref validation.
App not found, or no draft version exists to save.
Version is already saved — no current draft exists on the app.
Request
curl -X POST "https://{your-domain}/api/ext/apps/{appIdOrSlug}/versions/save" \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json" \
-d '{"name": "v1.2.0"}'Response — 201
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"name": "v1.2.0",
"appId": "f9e8d7c6-b5a4-3210-fedc-ba9876543210",
"status": "published",
"currentEnvironmentId": "11223344-5566-7788-99aa-bbccddeeff00",
"versionType": "version",
"createdAt": "2026-06-09T10:00:00.000Z",
"updatedAt": "2026-06-09T10:05:00.000Z"
}