Skip to main content
POST
Upload an asset

Authorizations

Authorization
string
header
required

Workspace API key, e.g. Authorization: Bearer tented_.... Create keys in Workspace Settings → API Keys.

Path Parameters

tentId
string
required

Tent ID, or the literal new to create an idle tent.

Body

multipart/form-data
file
file
required

The file to upload (max 4 MB).

Response

Asset stored.

actual_tent_id
string<uuid>
required

Tent the asset was attached to. When you upload to /v1/tents/new/assets, this is the newly created idle tent — pass it as tent_id to POST /v1/tents.

asset_id
string
required

Asset ID. Reference it in asset_ids when creating or editing the tent.

filename
string
required

Original file name.

content_type
string
required

MIME type of the uploaded file.

file_size
integer
required

File size in bytes.

uploaded_at
string<date-time>
required

Upload timestamp.