Skip to content

Delete a part

DELETE
/parts/{id}
curl --request DELETE \
--url https://app.buildtrace.eu/api/parts/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
--header 'Authorization: Bearer <token>'

Delete a part. Allowed only while the part is not yet in use: not referenced by any BOM line, alternate, or ECO, with no BOM content of its own, and nothing built against it (units/stock). The auto-created initial revision is removed with it. Returns 409 once the part is in use.

Required scope: parts:write.

id
required
string format: uuid

Deleted

Unauthorized

Not found

The part is in use (the message names where) and can’t be deleted; deprecate it instead

Media typeapplication/json
object
error
required
string

Example generated

{
"error": "example"
}