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>"
  ]
}
'

Documentation Index

Fetch the complete documentation index at: https://docs.metabind.ai/llms.txt

Use this file to discover all available pages before exploring further.

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"]
  }'