The Apiera REST API provides programmatic access to the Apiera platform, enabling seamless integration with your existing systems and workflows.
Apiera REST API (1.1.0)
Variation type indicating the intended use of a file.
| Enum Value | Description |
|---|---|
| original | The original unmodified source file. |
| thumbnail | A small preview image. |
| webOptimized | Optimized for web display. |
| mobileOptimized | Optimized for mobile devices. |
| productDetail | Sized for product detail pages. |
| printReady | High-resolution file suitable for print. |
| socialMedia | Formatted for social media platforms. |
| videoPoster | A static poster image for a video. |
| videoPreview | A short preview clip of a video. |
| videoStreamLow | Low-quality video stream variant. |
Storage backend where asset files are stored.
| Value | Description |
|---|---|
| s3 | Amazon S3 object storage. |
- Mock serverhttps://docs.apiera.io/_mock/openapi/v1/assets/files/bulk/actions/initiate-upload
- Productionhttps://api.apiera.io/v1/assets/files/bulk/actions/initiate-upload
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://docs.apiera.io/_mock/openapi/v1/assets/files/bulk/actions/initiate-upload \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '[
{
"assetUuid": "ee6af44a-bc5b-48d8-8594-0296d309de33",
"variationType": "original",
"storageLocation": "s3",
"mimeType": "string",
"extension": "string"
}
]'The created files with presigned upload URLs.
Timestamp when this file was created.
Upload status of a file.
| Enum Value | Description |
|---|---|
| awaitingUpload | The file record has been created but the binary has not yet been uploaded. |
| uploaded | The file binary has been successfully uploaded. |
Variation type indicating the intended use of a file.
| Enum Value | Description |
|---|---|
| original | The original unmodified source file. |
| thumbnail | A small preview image. |
| webOptimized | Optimized for web display. |
| mobileOptimized | Optimized for mobile devices. |
| productDetail | Sized for product detail pages. |
| printReady | High-resolution file suitable for print. |
| socialMedia | Formatted for social media platforms. |
| videoPoster | A static poster image for a video. |
| videoPreview | A short preview clip of a video. |
| videoStreamLow | Low-quality video stream variant. |
Storage backend where asset files are stored.
| Value | Description |
|---|---|
| s3 | Amazon S3 object storage. |
[ { "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f", "assetUuid": "ee6af44a-bc5b-48d8-8594-0296d309de33", "createdAt": "2025-11-23T14:15:22.123456Z", "status": "awaitingUpload", "variationType": "original", "storageLocation": "s3", "mimeType": "string", "extension": "string", "storageSize": 0, "checksum": "string", "isAutogenerated": true, "presignedUrl": "string" } ]
SHA-256 checksum of the uploaded file for integrity verification.
- Mock serverhttps://docs.apiera.io/_mock/openapi/v1/assets/files/bulk/actions/complete-upload
- Productionhttps://api.apiera.io/v1/assets/files/bulk/actions/complete-upload
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X PATCH \
https://docs.apiera.io/_mock/openapi/v1/assets/files/bulk/actions/complete-upload \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '[
{
"assetUuid": "ee6af44a-bc5b-48d8-8594-0296d309de33",
"fileUuid": "cfc6962f-d401-4825-9c0a-77bccac9ba59",
"checksum": "stringstringstringstringstringstringstringstringstringstringstri"
}
]'The files after upload completion.
Timestamp when this file was created.
Upload status of a file.
| Enum Value | Description |
|---|---|
| awaitingUpload | The file record has been created but the binary has not yet been uploaded. |
| uploaded | The file binary has been successfully uploaded. |
Variation type indicating the intended use of a file.
| Enum Value | Description |
|---|---|
| original | The original unmodified source file. |
| thumbnail | A small preview image. |
| webOptimized | Optimized for web display. |
| mobileOptimized | Optimized for mobile devices. |
| productDetail | Sized for product detail pages. |
| printReady | High-resolution file suitable for print. |
| socialMedia | Formatted for social media platforms. |
| videoPoster | A static poster image for a video. |
| videoPreview | A short preview clip of a video. |
| videoStreamLow | Low-quality video stream variant. |
Storage backend where asset files are stored.
| Value | Description |
|---|---|
| s3 | Amazon S3 object storage. |
[ { "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f", "assetUuid": "ee6af44a-bc5b-48d8-8594-0296d309de33", "createdAt": "2025-11-23T14:15:22.123456Z", "status": "awaitingUpload", "variationType": "original", "storageLocation": "s3", "mimeType": "string", "extension": "string", "storageSize": 0, "checksum": "string", "isAutogenerated": true, "presignedUrl": "string" } ]
| Items Enum Value | Description |
|---|---|
| awaitingUpload | The file record has been created but the binary has not yet been uploaded. |
| uploaded | The file binary has been successfully uploaded. |
| Items Enum Value | Description |
|---|---|
| original | The original unmodified source file. |
| thumbnail | A small preview image. |
| webOptimized | Optimized for web display. |
| mobileOptimized | Optimized for mobile devices. |
| productDetail | Sized for product detail pages. |
| printReady | High-resolution file suitable for print. |
| socialMedia | Formatted for social media platforms. |
| videoPoster | A static poster image for a video. |
| videoPreview | A short preview clip of a video. |
| videoStreamLow | Low-quality video stream variant. |
- Mock serverhttps://docs.apiera.io/_mock/openapi/v1/assets/{assetUuid}/files
- Productionhttps://api.apiera.io/v1/assets/{assetUuid}/files
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://docs.apiera.io/_mock/openapi/v1/assets/{assetUuid}/files?uuids%5Beq%5D=497f6eca-6276-4993-bfeb-53cbbbba6f08&statuses%5Beq%5D=awaitingUpload&status%5Border%5D=string&variationTypes%5Beq%5D=original&variationType%5Border%5D=string&mimeTypes%5Beq%5D=string&extensions%5Beq%5D=string&extension%5Bcontains%5D=string&extension%5Bstarts%5D=string&extension%5Bends%5D=string&isAutogenerated%5Beq%5D=true&createdAt%5Beq%5D=2025-11-23T14%3A15%3A22.123456Z&createdAt%5Bmin%5D=2025-11-23T14%3A15%3A22.123456Z&createdAt%5Bmax%5D=2025-11-23T14%3A15%3A22.123456Z&createdAt%5Border%5D=string&storageSize%5Border%5D=string&page=0&size=0' \
-H 'Authorization: Bearer <YOUR_JWT_HERE>'A paginated list of asset files.
Timestamp when this file was created.
Upload status of a file.
| Enum Value | Description |
|---|---|
| awaitingUpload | The file record has been created but the binary has not yet been uploaded. |
| uploaded | The file binary has been successfully uploaded. |
Variation type indicating the intended use of a file.
| Enum Value | Description |
|---|---|
| original | The original unmodified source file. |
| thumbnail | A small preview image. |
| webOptimized | Optimized for web display. |
| mobileOptimized | Optimized for mobile devices. |
| productDetail | Sized for product detail pages. |
| printReady | High-resolution file suitable for print. |
| socialMedia | Formatted for social media platforms. |
| videoPoster | A static poster image for a video. |
| videoPreview | A short preview clip of a video. |
| videoStreamLow | Low-quality video stream variant. |
Storage backend where asset files are stored.
| Value | Description |
|---|---|
| s3 | Amazon S3 object storage. |
{ "items": [ { … } ], "pagination": { "page": 0, "size": 0, "totalItems": 0, "totalPages": 0 } }
- Mock serverhttps://docs.apiera.io/_mock/openapi/v1/assets/{assetUuid}/files/{fileUuid}
- Productionhttps://api.apiera.io/v1/assets/{assetUuid}/files/{fileUuid}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://docs.apiera.io/_mock/openapi/v1/assets/{assetUuid}/files/{fileUuid}' \
-H 'Authorization: Bearer <YOUR_JWT_HERE>'The requested file.
Timestamp when this file was created.
Upload status of a file.
| Enum Value | Description |
|---|---|
| awaitingUpload | The file record has been created but the binary has not yet been uploaded. |
| uploaded | The file binary has been successfully uploaded. |
Variation type indicating the intended use of a file.
| Enum Value | Description |
|---|---|
| original | The original unmodified source file. |
| thumbnail | A small preview image. |
| webOptimized | Optimized for web display. |
| mobileOptimized | Optimized for mobile devices. |
| productDetail | Sized for product detail pages. |
| printReady | High-resolution file suitable for print. |
| socialMedia | Formatted for social media platforms. |
| videoPoster | A static poster image for a video. |
| videoPreview | A short preview clip of a video. |
| videoStreamLow | Low-quality video stream variant. |
Storage backend where asset files are stored.
| Value | Description |
|---|---|
| s3 | Amazon S3 object storage. |
{ "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "assetUuid": "a1b2c3d4-5678-9012-3456-789012345678", "createdAt": "2025-01-15T10:30:00.000000Z", "status": "uploaded", "variationType": "original", "storageLocation": "s3", "mimeType": "image/jpeg", "extension": ".jpg", "storageSize": 204800, "checksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "isAutogenerated": false, "presignedUrl": "https://storage.example.com/files/3fa85f64.jpg?token=abc123" }
- Mock serverhttps://docs.apiera.io/_mock/openapi/v1/assets/{assetUuid}/files/{fileUuid}
- Productionhttps://api.apiera.io/v1/assets/{assetUuid}/files/{fileUuid}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X DELETE \
'https://docs.apiera.io/_mock/openapi/v1/assets/{assetUuid}/files/{fileUuid}' \
-H 'Authorization: Bearer <YOUR_JWT_HERE>'Request
Initiates an upload for a new file within an asset. Returns a presigned URL for uploading the file content.
Variation type indicating the intended use of a file.
| Enum Value | Description |
|---|---|
| original | The original unmodified source file. |
| thumbnail | A small preview image. |
| webOptimized | Optimized for web display. |
| mobileOptimized | Optimized for mobile devices. |
| productDetail | Sized for product detail pages. |
| printReady | High-resolution file suitable for print. |
| socialMedia | Formatted for social media platforms. |
| videoPoster | A static poster image for a video. |
| videoPreview | A short preview clip of a video. |
| videoStreamLow | Low-quality video stream variant. |
Storage backend where asset files are stored.
| Value | Description |
|---|---|
| s3 | Amazon S3 object storage. |
- Mock serverhttps://docs.apiera.io/_mock/openapi/v1/assets/{assetUuid}/files/actions/initiate-upload
- Productionhttps://api.apiera.io/v1/assets/{assetUuid}/files/actions/initiate-upload
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
'https://docs.apiera.io/_mock/openapi/v1/assets/{assetUuid}/files/actions/initiate-upload' \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"variationType": "original",
"storageLocation": "s3",
"mimeType": "string",
"extension": "string"
}'The created file with a presigned upload URL.
Timestamp when this file was created.
Upload status of a file.
| Enum Value | Description |
|---|---|
| awaitingUpload | The file record has been created but the binary has not yet been uploaded. |
| uploaded | The file binary has been successfully uploaded. |
Variation type indicating the intended use of a file.
| Enum Value | Description |
|---|---|
| original | The original unmodified source file. |
| thumbnail | A small preview image. |
| webOptimized | Optimized for web display. |
| mobileOptimized | Optimized for mobile devices. |
| productDetail | Sized for product detail pages. |
| printReady | High-resolution file suitable for print. |
| socialMedia | Formatted for social media platforms. |
| videoPoster | A static poster image for a video. |
| videoPreview | A short preview clip of a video. |
| videoStreamLow | Low-quality video stream variant. |
Storage backend where asset files are stored.
| Value | Description |
|---|---|
| s3 | Amazon S3 object storage. |
{ "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "assetUuid": "a1b2c3d4-5678-9012-3456-789012345678", "createdAt": "2025-01-15T10:30:00.000000Z", "status": "awaitingUpload", "variationType": "original", "storageLocation": "s3", "mimeType": "image/jpeg", "extension": ".jpg", "checksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "isAutogenerated": false, "presignedUrl": "https://storage.example.com/files/3fa85f64.jpg?token=abc123" }
Request
Marks a file upload as complete after the file content has been uploaded to the presigned URL.
- Mock serverhttps://docs.apiera.io/_mock/openapi/v1/assets/{assetUuid}/files/{fileUuid}/actions/complete-upload
- Productionhttps://api.apiera.io/v1/assets/{assetUuid}/files/{fileUuid}/actions/complete-upload
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X PATCH \
'https://docs.apiera.io/_mock/openapi/v1/assets/{assetUuid}/files/{fileUuid}/actions/complete-upload' \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"checksum": "stringstringstringstringstringstringstringstringstringstringstri"
}'The file after upload completion.
Timestamp when this file was created.
Upload status of a file.
| Enum Value | Description |
|---|---|
| awaitingUpload | The file record has been created but the binary has not yet been uploaded. |
| uploaded | The file binary has been successfully uploaded. |
Variation type indicating the intended use of a file.
| Enum Value | Description |
|---|---|
| original | The original unmodified source file. |
| thumbnail | A small preview image. |
| webOptimized | Optimized for web display. |
| mobileOptimized | Optimized for mobile devices. |
| productDetail | Sized for product detail pages. |
| printReady | High-resolution file suitable for print. |
| socialMedia | Formatted for social media platforms. |
| videoPoster | A static poster image for a video. |
| videoPreview | A short preview clip of a video. |
| videoStreamLow | Low-quality video stream variant. |
Storage backend where asset files are stored.
| Value | Description |
|---|---|
| s3 | Amazon S3 object storage. |
{ "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "assetUuid": "a1b2c3d4-5678-9012-3456-789012345678", "createdAt": "2025-01-15T10:30:00.000000Z", "status": "uploaded", "variationType": "original", "storageLocation": "s3", "mimeType": "image/jpeg", "extension": ".jpg", "storageSize": 204800, "checksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "isAutogenerated": false, "presignedUrl": "https://storage.example.com/files/3fa85f64.jpg?token=abc123" }