Sandbox images

Share a sandbox image with the project

Changed on

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

Request

  • Base URL
    https://app.mcpjam.com/api/v1
  • URL
    https://app.mcpjam.com/api/v1/projects/{projectId}/images/{imageId}/promote
  • Auth
    HTTP bearer

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.

Changes

  • c3f63a334176Revision changes
    • breaking

      removed the required property from the response with the status

    • info

      added the required property to the response with the status

  • 8e393fd5825fRevision changes
    • warning

      added the new CONFLICT enum value to the response property for the response status

    • warning

      added the new CONFLICT enum value to the response property for the response status

    • warning

      added the new CONFLICT enum value to the response property for the response status

    • warning

      added the new CONFLICT enum value to the response property for the response status

    • warning

      added the new CONFLICT enum value to the response property for the response status

    • warning

      added the new CONFLICT enum value to the response property for the response status

    • warning

      added the new CONFLICT enum value to the response property for the response status