Skip to main content
PUT
/
api
/
v1
/
organizations
/
{organizationId}
/
projects
/
{projectId}
/
assets
/
{id}
curl -X PUT "https://api.metabind.ai/api/v1/organizations/org123/projects/proj456/assets/asset789" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "updated-hero-image.jpg",
    "metadata": {
      "alt": "Updated hero image",
      "caption": "New product showcase"
    },
    "tags": ["hero", "product", "featured"]
  }'

{
  "data": {
    "id": "asset789",
    "name": "updated-hero-image.jpg",
    "description": null,
    "type": "image/jpeg",
    "status": "active",
    "url": "https://cdn.metabind.ai/org123/proj456/assets/asset789/updated-hero-image.jpg",
    "size": 2048576,
    "metadata": {
      "width": 1920,
      "height": 1080,
      "format": "jpeg",
      "alt": "Updated hero image",
      "caption": "New product showcase"
    },
    "tags": ["hero", "product", "featured"],
    "createdAt": "2024-03-20T10:00:00Z",
    "updatedAt": "2024-03-21T15:30:00Z"
  }
}
Update an asset’s metadata, name, description, or tags. The file itself cannot be replaced - upload a new asset instead.

​
Path Parameters

​
organizationId
string
required
The unique identifier of the organization
​
projectId
string
required
The unique identifier of the project
​
id
string
required
The unique identifier of the asset

​
Request Body

​
name
string
New display name for the asset
​
description
string
New description following the structured markdown format
​
metadata
object
Updated metadata object. Merged with existing metadata.
​
tags
string[]
New array of tag IDs. Replaces existing tags.

​
Response

Returns the updated Asset object. 
curl -X PUT "https://api.metabind.ai/api/v1/organizations/org123/projects/proj456/assets/asset789" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "updated-hero-image.jpg",
    "metadata": {
      "alt": "Updated hero image",
      "caption": "New product showcase"
    },
    "tags": ["hero", "product", "featured"]
  }'

{
  "data": {
    "id": "asset789",
    "name": "updated-hero-image.jpg",
    "description": null,
    "type": "image/jpeg",
    "status": "active",
    "url": "https://cdn.metabind.ai/org123/proj456/assets/asset789/updated-hero-image.jpg",
    "size": 2048576,
    "metadata": {
      "width": 1920,
      "height": 1080,
      "format": "jpeg",
      "alt": "Updated hero image",
      "caption": "New product showcase"
    },
    "tags": ["hero", "product", "featured"],
    "createdAt": "2024-03-20T10:00:00Z",
    "updatedAt": "2024-03-21T15:30:00Z"
  }
}