Sign in

v44

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-20129390589.6 KB
Images

Complete image upload

⚠️ This endpoint is in public preview.

Finalize a multipart image upload.

post/preview/v2/images/{id}/complete

Path parameters

idstring required

A resource path like 'sfc:image:acme:prod:my-image' or an ID. Resource paths are human-readable but not stable - they change when resources are renamed or moved. IDs are stable and permanent.

Example:image_k3R-nX9vLm7Qp2Yw5Jd8F

Image ID, name, or resource path

Request body

sha256string required

Not verified on upload; used during instance boot to verify integrity.

Response

Upload completed

idstring required
resource_pathstring required

A resource path for a image resource. Format: sfc:image:<account>:<workspace>:<name>.

ownerstring required
workspacestring required
namestring required
object'image' required
upload_status'started' | 'uploading' | 'completed' | 'failed' | 'revoked' required
sha256string nullable
created_atinteger required

Unix timestamp.

Example response

{
  "id": "image_k3R-nX9vLm7Qp2Yw5Jd8F",
  "resource_path": "sfc:image:<account_id>:<workspace>:<name>",
  "owner": "my-resource-name",
  "workspace": "my-resource-name",
  "name": "my-resource-name",
  "object": "image",
  "created_at": 1738972800
}