Delete Asset
delete_asset_companyDelete a company asset and all associated attachments and change history. Use cascade=true to remove descendant assets atomically; otherwise, assets with children return a 409 conflict.
Instructions
Deletes a company asset and all its associated attachments and change history. If the asset has descendants in the asset hierarchy, the caller must opt in with ?cascade=true; otherwise the request fails with HTTP 409 and the response body lists the blocking descendants so the UI can prompt for confirmation. Confirm the target id with the matching show or list tool before calling. company_id defaults to the value set by procore_set_config when omitted, and asset_id must identify an existing parent record — resolve it with the matching list tool first. Permanently removes the asset. This cannot be undone, and a repeat call returns 404. Failures come back as an error payload carrying the HTTP status — commonly 401 when the token has expired, 403 without tool permission, and 404 when an id does not resolve. Required parameters: company_id, asset_id. Procore API (v2.0): Core > Assets. Endpoint: DELETE /rest/v2.0/companies/{company_id}/assets/{asset_id}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cascade | No | Query string parameter — when true, also delete every descendant asset in the subtree atomically. Defaults to false; required when the asset has children. | |
| asset_id | Yes | URL path parameter — unique identifier for the asset | |
| company_id | Yes | URL path parameter — unique identifier for the company. | |
| Accept-Language | No | JSON request body field — locale for localized response messages (for example: en, fr-FR, pseudo) |