v1

latestOpenAPI 3.0.32026-07-22194221292.5 KB

images

Share a container image

Shares a container image with another workspace by copying the metadata record. The underlying storage (S3) data is not duplicated. For same-account targets the share is applied immediately. For cross-account targets, a pending image share is created and must be explicitly accepted by an admin of the target workspace; the correct target account ID must be supplied as an anti-spam measure.

post/images/{resourceType}/{imageName}/share

Request body

targetAccountIdstring

Account ID of the target workspace. Required when the target workspace belongs to a different account than the source workspace (anti-spam).

targetWorkspacestring required

Name of the workspace to share the image with

Response

successful operation (same-account share, applied immediately)

Example response

{
  "metadata": {
    "events": [
      {
        "message": "Deployment successful",
        "revision": "rev-abc123",
        "status": "DEPLOYED",
        "time": "2025-01-15T10:30:00Z",
        "type": "deployment"
      }
    ]
  }
}