Skip to main content
DELETE
/
v1
/
organizations
/
{organizationId}
/
projects
/
{projectId}
/
components
/
{id}
Delete Component
curl --request DELETE \
  --url https://api.example.com/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

{
  "error": {
    "code": "COMPONENT_IN_USE",
    "message": "Cannot delete component referenced by packages",
    "details": {
      "referencedByPackages": ["1.0.0", "1.1.0", "2.0.0"]
    }
  }
}

Not Found

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

Code Examples

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