Sign in

v8

latestOpenAPI 3.1.1LicenseRef-Proprietaryraw.githubusercontent.com2026-05-19280916.6 KB
Assets

Complete a signed asset upload

Marks a signed asset upload as complete after the file has been uploaded. Mutating public API requests support an optional Idempotency-Key header for client retries; duplicate keys within two hours return idempotency_duplicate.

post/assets/{assetId}/complete

Path parameters

assetIdstring required

Asset identifier

Example:asset_abc123

Asset identifier

Response

Asset upload completed.

asset_idstring required

Asset identifier

urlstring uri nullable required

Asset URL

workspace_idstring nullable required

Workspace identifier

visibility'workspace' required
status'pending_upload' | 'ready' | 'failed' required
failure_messagestring nullable

Failure message when the asset is in failed status

upload_urlstring

Upload URL (serialized)

expires_atstring date-time

Expiration time for the upload URL

Example response

{
  "asset_id": "asset_abc123",
  "workspace_id": "ws_abc123",
  "upload_url": "https://upload.imagekit.io/api/v1/files/upload"
}