curl -X POST "https://api.metabind.ai/app/v1/organizations/org123/projects/proj456/assets" \
-H "Authorization: Bearer YOUR_JWT" \
-F "file=@/path/to/image.jpg" \
-F 'metadata={"alt": "Product hero image"}' \
-F 'tags=["hero", "product"]'
const formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('metadata', JSON.stringify({ alt: 'Product hero image' }));
formData.append('tags', JSON.stringify(['hero', 'product']));
const response = await fetch(
'https://api.metabind.ai/app/v1/organizations/org123/projects/proj456/assets',
{
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_JWT'
},
body: formData
}
);
const data = await response.json();
{
"data": {
"id": "asset789",
"name": "image.jpg",
"description": null,
"type": "image/jpeg",
"status": "active",
"url": "https://cdn.metabind.ai/org123/proj456/assets/asset789/image.jpg",
"size": 1536000,
"metadata": {
"width": 1920,
"height": 1080,
"format": "jpeg",
"alt": "Product hero image"
},
"tags": ["hero", "product"],
"createdAt": "2024-03-21T14:30:00Z",
"updatedAt": "2024-03-21T14:30:00Z"
}
}
{
"error": {
"code": "INVALID_FILE_TYPE",
"message": "File type \"text/html\" is not allowed. Only images, videos, audio, PDFs, and fonts are permitted."
}
}
Assets
Upload Asset
Upload a new media file to the project
POST
/
app
/
v1
/
organizations
/
{organizationId}
/
projects
/
{projectId}
/
assets
curl -X POST "https://api.metabind.ai/app/v1/organizations/org123/projects/proj456/assets" \
-H "Authorization: Bearer YOUR_JWT" \
-F "file=@/path/to/image.jpg" \
-F 'metadata={"alt": "Product hero image"}' \
-F 'tags=["hero", "product"]'
const formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('metadata', JSON.stringify({ alt: 'Product hero image' }));
formData.append('tags', JSON.stringify(['hero', 'product']));
const response = await fetch(
'https://api.metabind.ai/app/v1/organizations/org123/projects/proj456/assets',
{
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_JWT'
},
body: formData
}
);
const data = await response.json();
{
"data": {
"id": "asset789",
"name": "image.jpg",
"description": null,
"type": "image/jpeg",
"status": "active",
"url": "https://cdn.metabind.ai/org123/proj456/assets/asset789/image.jpg",
"size": 1536000,
"metadata": {
"width": 1920,
"height": 1080,
"format": "jpeg",
"alt": "Product hero image"
},
"tags": ["hero", "product"],
"createdAt": "2024-03-21T14:30:00Z",
"updatedAt": "2024-03-21T14:30:00Z"
}
}
{
"error": {
"code": "INVALID_FILE_TYPE",
"message": "File type \"text/html\" is not allowed. Only images, videos, audio, PDFs, and fonts are permitted."
}
}
Upload a new asset to the project. This endpoint accepts multipart/form-data for file uploads.
This endpoint uses
multipart/form-data, not JSON. The file is sent as binary data.Path Parameters
string
required
The unique identifier of the organization
string
required
The unique identifier of the project
Request Body
file
required
The file to upload. Supported formats include images (JPEG, PNG, GIF, WebP, AVIF), videos (MP4, MOV, WebM), and documents (PDF).
string
JSON string containing metadata object. Will be parsed and stored with the asset.
{
"alt": "Hero image description",
"caption": "Photo by John Doe"
}
string
JSON string array of tag IDs to associate with the asset.
["hero", "homepage", "featured"]
Response
Returns the created Asset object.Asset
The newly created asset object with generated ID and CDN URL
curl -X POST "https://api.metabind.ai/app/v1/organizations/org123/projects/proj456/assets" \
-H "Authorization: Bearer YOUR_JWT" \
-F "file=@/path/to/image.jpg" \
-F 'metadata={"alt": "Product hero image"}' \
-F 'tags=["hero", "product"]'
const formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('metadata', JSON.stringify({ alt: 'Product hero image' }));
formData.append('tags', JSON.stringify(['hero', 'product']));
const response = await fetch(
'https://api.metabind.ai/app/v1/organizations/org123/projects/proj456/assets',
{
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_JWT'
},
body: formData
}
);
const data = await response.json();
{
"data": {
"id": "asset789",
"name": "image.jpg",
"description": null,
"type": "image/jpeg",
"status": "active",
"url": "https://cdn.metabind.ai/org123/proj456/assets/asset789/image.jpg",
"size": 1536000,
"metadata": {
"width": 1920,
"height": 1080,
"format": "jpeg",
"alt": "Product hero image"
},
"tags": ["hero", "product"],
"createdAt": "2024-03-21T14:30:00Z",
"updatedAt": "2024-03-21T14:30:00Z"
}
}
{
"error": {
"code": "INVALID_FILE_TYPE",
"message": "File type \"text/html\" is not allowed. Only images, videos, audio, PDFs, and fonts are permitted."
}
}