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>",
  "targetAccountId": "<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>"
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.blaxel.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

targetAccountId
string

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

Response

successful operation (same-account share, applied immediately)

metadata
object
required
spec
object
required
Last modified on May 13, 2026