POSTassets:write

Create asset metadata

Create asset metadata after uploading or preparing media externally.

Request

POST /api/assets

Authorization: Bearer <api_key>

Representative request body

{
  "key": "orgs/example/assets/2026/08/launch-video.mp4",
  "filename": "launch-video.mp4",
  "mimeType": "video/mp4",
  "size": 10485760
}

Examples

curl -X POST "https://api.creagency.ai/api/assets" \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "key": "orgs/example/assets/2026/08/launch-video.mp4",
    "filename": "launch-video.mp4",
    "mimeType": "video/mp4",
    "size": 10485760
  }'

Responses

200

Asset created

400

Validation error

401

Missing, invalid, expired, or revoked API key

403

Missing assets:write scope