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
Request Body
The file to upload. Supported formats include images (JPEG, PNG, GIF, WebP, AVIF), videos (MP4, MOV, WebM), and documents (PDF).
JSON string containing metadata object. Will be parsed and stored with the asset.
{
"alt": "Hero image description",
"caption": "Photo by John Doe"
}
Response
Returns the created Asset object.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."
}
}