Sign in

v20

OpenAPI 3.1.0raw.githubusercontent.com2026-08-035471202.8 KB
Sandbox images

Share a sandbox image with the project

Promote a personal-draft sandbox image to a project-shared one. Requires project admin. Bodyless. Guest callers are denied (a write).

post/projects/{projectId}/images/{imageId}/promote

Path parameters

projectIdstring required

ID of the hosted project that contains the server.

imageIdstring required

Sandbox image ID, as returned by the project's image list.

Request body

object required

Response

The now-shared sandbox image.

idstring required
projectIdstring required
namestring required
contentHashstring required
sharing'user' | 'project' required

user = a personal draft; project = shared with the whole project.

isOwnerboolean required
createdAtnumber required
updatedAtnumber required
blueprintstring required

The image's blueprint YAML (base / initialize / maintenance / knowledge). base must be an allowlisted official image pinned by sha256 digest.