Skip to main content
POST
/
images
/
{resourceType}
/
{imageName}
/
share
Share a container image
curl --request POST \
  --url https://api.blaxel.ai/v0/images/{resourceType}/{imageName}/share \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "targetWorkspace": "<string>"
}
'
{
  "metadata": {
    "createdAt": "<string>",
    "displayName": "<string>",
    "events": [
      {
        "canaryRevision": "<string>",
        "message": "Deployment successful",
        "revision": "rev-abc123",
        "status": "DEPLOYED",
        "time": "2025-01-15T10:30:00Z",
        "type": "deployment"
      }
    ],
    "lastDeployedAt": "<string>",
    "name": "<string>",
    "resourceType": "<string>",
    "sourceWorkspace": "<string>",
    "status": "DELETING",
    "updatedAt": "<string>",
    "workspace": "<string>"
  },
  "spec": {
    "size": 123,
    "tags": [
      {
        "createdAt": "<string>",
        "name": "<string>",
        "size": 123,
        "updatedAt": "<string>"
      }
    ]
  }
}

Authorizations

Authorization
string
header
required

OAuth2 authentication with JWT tokens

Path Parameters

resourceType
string
required

Resource type (agents, functions, sandboxes, jobs)

imageName
string
required

Name of the container image repository

Body

application/json
targetWorkspace
string
required

Name of the workspace to share the image with

Response

successful operation

metadata
object
required
spec
object
required
Last modified on April 14, 2026