Airogel CMS Docs

File uploads including images, documents, videos, and other media files.

Supported Operations

GET /v1/accounts/:account_id/assets - List assets
GET /v1/accounts/:account_id/assets/:id - Get an asset
POST /v1/accounts/:account_id/assets - Upload an asset
PUT /v1/accounts/:account_id/assets/:id - Update asset metadata
DELETE /v1/accounts/:account_id/assets/:id - Delete an asset

Upload Methods

Assets can be uploaded using two methods:

1. Multipart Form Data (recommended for binary files)

POST /v1/accounts/:account_id/assets
Content-Type: multipart/form-data

file: <binary>
path: images/blog

2. Base64 JSON (for API integrations)

POST /v1/accounts/:account_id/assets
Content-Type: application/json

{
  "asset": {
    "filename": "photo.jpg",
    "content_type": "image/jpeg",
    "path": "images/blog",
    "data": "base64encodeddata..."
  }
}

Parameters

Name	Type	Required	Description
`account_id`	string	Required	Your account ID
`path`	string	Optional	Optional folder path (e.g., 'images/blog')
`page`	integer	Optional	Page number (default: 1)

Request Example

# Multipart upload
curl -X POST \
  -H "Authorization: Bearer $API_TOKEN" \
  -F "file=@photo.jpg" \
  -F "path=uploads/2024/03" \
  https://api.airogelcms.com/v1/accounts/$ACCOUNT_ID/assets

# Base64 JSON upload
curl -X POST \
  -H "Authorization: Bearer $API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "asset": {
      "filename": "photo.jpg",
      "content_type": "image/jpeg",
      "path": "images/blog",
      "data": "iVBORw0KG..."
    }
  }' \
  https://api.airogelcms.com/v1/accounts/$ACCOUNT_ID/assets

Response Example

{
  "id": "acass_abc123",
  "filename": "photo.jpg",
  "content_type": "image/jpeg",
  "path": "uploads/2024/03",
  "url": "/assets/uploads/2024/03/photo.jpg",
  "file_size": 245678,
  "created_at": "2025-01-08T12:00:00Z",
  "updated_at": "2025-01-08T12:00:00Z"
}

Additional Notes

Supported file types: Most common formats including images (JPG, PNG, GIF, WebP, SVG), documents (PDF, DOC, DOCX), videos (MP4, WebM), and more.

File organization: Use the path parameter to organize files into folders (e.g., 'images/blog', 'uploads/2024/03').

Using assets in entries: Reference assets by their path (e.g., 'uploads/2024/03/photo.jpg') or prefix ID (e.g., 'acass_abc123').