> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tented.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Uploading Assets
> Upload, list, retrieve, and delete files on tents, emails, email templates, and tent templates.
## Endpoints
```bash theme={null}
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:
```bash theme={null}
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:
```bash theme={null}
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
```bash theme={null}
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`
```json theme={null}
{
"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
```bash theme={null}
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`:
```json theme={null}
{
"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:
```bash theme={null}
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](/api-reference/editing-emails#iterate-with-ai), [an email template](/api-reference/managing-email-templates#iterate-with-ai), or [a tent template](/api-reference/managing-tent-templates#iterate-with-ai).
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
Use your uploaded asset IDs in the tent creation request.