Uploading Assets

Endpoints

POST   /v1/tents/{tentId}/assets
GET    /v1/tents/{tentId}/assets
GET    /v1/tents/{tentId}/assets/{assetId}
DELETE /v1/tents/{tentId}/assets/{assetId}

Use this endpoint when your prompt should reference uploaded files such as:

Logos and product images
PDFs and Word documents
CSV or spreadsheet files
Slide decks
Video and audio files

Two Supported Patterns

Upload to a new tent

Use new as the path parameter:

POST /v1/tents/new/assets

Tented creates an idle tent and returns:

actual_tent_id
asset_id

Use those values in your later POST /v1/tents request.

Upload to an existing tent

If you already have a tentId, attach more files to the same tent:

POST /v1/tents/{existingTentId}/assets

The upload endpoint only checks that the tent exists in your workspace. If you plan to use that tent_id with POST /v1/tents, the tent must still have no generation yet.

Request Format

Send multipart/form-data with a single field named file.

Request Example

curl --request POST \
  --url https://api.tented.ai/v1/tents/new/assets \
  --header "Authorization: Bearer $TENTED_API_KEY" \
  --form "file=@./brand-brief.pdf"

Response Example

201 Created

{
  "requested_tent_id": "new",
  "actual_tent_id": "f11ef3cf-8664-4fe5-a261-c5b4d647b7d1",
  "asset_id": "01JPAEWP9PY5SCX1V6X03XK9M2",
  "filename": "brand-brief.pdf",
  "content_type": "application/pdf",
  "file_size": 248392,
  "uploaded_at": "2026-03-13T15:35:00.000Z"
}

File Limits

Maximum file size: 4 MB per upload
Maximum referenced assets on create: 5
One file per request

Supported Content Types

Images

image/png
image/jpeg
image/gif
image/svg+xml
image/webp
image/x-icon
image/tiff
image/avif

Documents

application/pdf
application/msword
application/vnd.openxmlformats-officedocument.wordprocessingml.document
text/markdown
text/plain
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
application/vnd.ms-excel
text/csv
application/vnd.ms-powerpoint
application/vnd.openxmlformats-officedocument.presentationml.presentation

Media

video/mp4
video/webm
video/quicktime
audio/mpeg
audio/wav

List, Retrieve, and Delete Assets

GET    /v1/tents/{tentId}/assets
GET    /v1/tents/{tentId}/assets/{assetId}
DELETE /v1/tents/{tentId}/assets/{assetId}

GET /v1/tents/{tentId}/assets returns every asset on the tent as {"assets": [...]}. GET .../{assetId} returns a single asset. Each asset carries a download_url:

{
  "asset_id": "01JPAEWP9PY5SCX1V6X03XK9M2",
  "filename": "brand-brief.pdf",
  "content_type": "application/pdf",
  "file_size": 248392,
  "uploaded_at": "2026-03-13T15:35:00.000Z",
  "uploaded_by": "tented-api",
  "download_url": "https://assets.tented.ai/tent-assets/..."
}

DELETE .../{assetId} removes the asset and deletes the underlying file, returning {"asset_id": "...", "deleted": true}. Deleting an asset that a published tent references does not alter the already-rendered page.

Assets on Emails, Templates, and Tent Templates

The same four operations work on emails, email templates, and tent templates — the only difference is the parent segment of the path:

POST   /v1/emails/{emailId}/assets
GET    /v1/emails/{emailId}/assets
GET    /v1/emails/{emailId}/assets/{assetId}
DELETE /v1/emails/{emailId}/assets/{assetId}

POST   /v1/email-templates/{templateId}/assets
GET    /v1/email-templates/{templateId}/assets
GET    /v1/email-templates/{templateId}/assets/{assetId}
DELETE /v1/email-templates/{templateId}/assets/{assetId}

POST   /v1/tent-templates/{templateId}/assets
GET    /v1/tent-templates/{templateId}/assets
GET    /v1/tent-templates/{templateId}/assets/{assetId}
DELETE /v1/tent-templates/{templateId}/assets/{assetId}

Upload is multipart/form-data with a single file field (max 4 MB), exactly like tent uploads, and returns the asset object shown above (with download_url). Reference the returned asset_id in the asset_ids array when iterating the parent with AI — see iterating an email, an email template, or a tent template.

Unlike tent uploads, there is no new shortcut for these parents — the email, email template, or tent template must already exist. Uploading to one that does not exist in your workspace returns 404 Not Found.

Common Errors

Status	Cause
`400 Bad Request`	`Content-Type` is not `multipart/form-data`
`400 Bad Request`	Request body is missing
`400 Bad Request`	No `file` field was provided
`400 Bad Request`	File is larger than `4 MB`
`400 Bad Request`	Unsupported MIME type
`400 Bad Request`	`tentId` is not `new` and is not a valid UUID
`401 Unauthorized`	Missing or invalid bearer token
`404 Not Found`	You referenced an existing tent that does not exist in your workspace

Next Step

After uploading, call POST /v1/tents and pass:

tent_id: the actual_tent_id
asset_ids: an array of the returned asset_id values

Next: Create Tents

Use your uploaded asset IDs in the tent creation request.

Tented API

Tents

Email

Contacts & Lists

Campaigns

Analytics

Endpoints

Two Supported Patterns

Upload to a new tent

Upload to an existing tent

Request Format

Request Example

Response Example

File Limits

Supported Content Types

Images

Documents

Media

List, Retrieve, and Delete Assets

Assets on Emails, Templates, and Tent Templates

Common Errors

Next Step

Next: Create Tents

​Endpoints

​Two Supported Patterns

​Upload to a new tent

​Upload to an existing tent

​Request Format

​Request Example

​Response Example

​File Limits

​Supported Content Types

​Images

​Documents

​Media

​List, Retrieve, and Delete Assets

​Assets on Emails, Templates, and Tent Templates

​Common Errors

​Next Step

Next: Create Tents

Endpoints

Two Supported Patterns

Upload to a new tent

Upload to an existing tent

Request Format

Request Example

Response Example

File Limits

Supported Content Types

Images

Documents

Media

List, Retrieve, and Delete Assets

Assets on Emails, Templates, and Tent Templates

Common Errors

Next Step