Skip to main content
DELETE
/
app
/
v1
/
organizations
/
{organizationId}
/
projects
/
{projectId}
/
components
/
{id}
Delete Component
curl --request DELETE \
  --url https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/components/{id}

Path Parameters

organizationId
string
required
Organization ID
projectId
string
required
Project ID
id
string
required
Component ID
Components referenced by packages cannot be deleted. Use the Update Status endpoint to set status to deleted instead, which prevents future use while maintaining package references.

Response

{
  "message": "Component successfully deleted",
  "id": "c123"
}

Error Responses

Component In Use by Draft Content Types

{
  "error": {
    "code": "COMPONENT_IN_USE_BY_DRAFT",
    "message": "Component cannot be deleted as it is used by 2 draft content type(s)",
    "details": {
      "contentTypes": [
        { "id": "ct123", "name": "Article" },
        { "id": "ct456", "name": "Product Page" }
      ]
    }
  }
}

Not Found

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

Code Examples

curl -X DELETE "https://api.metabind.ai/app/v1/organizations/org123/projects/proj456/components/c123" \
  -H "Authorization: Bearer YOUR_JWT"