Skip to main content
PUT
/
app
/
v1
/
organizations
/
{organizationId}
/
projects
/
{projectId}
/
components
/
{componentId}
/
assets
/
{assetId}
Update Component Asset
curl --request PUT \
  --url https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/components/{componentId}/assets/{assetId} \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "metadata": {},
  "tags": [
    "<string>"
  ]
}
'

​
Path Parameters

​
organizationId
string
required
Organization ID
​
projectId
string
required
Project ID
​
componentId
string
required
Component ID
​
assetId
string
required
Asset ID

​
Request Body

​
name
string
Asset name (1-255 characters)
​
metadata
object
Custom metadata object
​
tags
string[]
Array of tags (max 20 tags, each 1-100 characters)

​
Example Request

{
  "name": "logo-primary-2x.png",
  "metadata": {
    "width": 200,
    "height": 100,
    "author": "Design Team"
  },
  "tags": ["logo", "brand", "primary"]
}

​
Response

Returns the updated Component Asset object. 
{
  "id": "asset123",
  "componentId": "c123",
  "name": "logo-primary-2x.png",
  "type": "image/png",
  "url": "https://cdn.metabind.ai/.../logo-primary-2x.png",
  "size": 24576,
  "status": "active",
  "metadata": {
    "width": 200,
    "height": 100,
    "author": "Design Team"
  },
  "tags": ["logo", "brand", "primary"],
  "createdAt": "2024-03-20T10:00:00Z",
  "updatedAt": "2024-03-22T10:00:00Z"
}

​
Error Responses

​
Asset Not Found

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Component asset not found"
  }
}

​
Code Examples

curl -X PUT "https://api.metabind.ai/app/v1/organizations/org123/projects/proj456/components/c123/assets/asset123" \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "logo-primary-2x.png",
    "tags": ["logo", "brand", "primary"]
  }'