---
id: package-delete
title: "Delete a package"
description: "Soft-delete a package. Its revisions are retained, so a service that points at one of them keeps resolving its bill of materials."
sidebar_label: "Delete a package"
hide_title: true
hide_table_of_contents: true
api: eJztVduO2zYQ/RViXpIA8m3XzkVvabJFU/Sh2N2iARZGMBJHFrMSyZAjZxeC/r0YSbbX9jbPKdAnXThDnjlneKYFTTEPxrNxFlK4cQVPNFXEpFB5zO9xQ1P1iaMKtDXROBsVBlKBGI0lnajoFKpIYWtyUlwiK++M5aiQlbOkXKG4pFrdE3nZJbpqa+xGGY4qM1UlATUyBYNVnEICzlNAwfNJQwojhnQABQkwbiKkd/DnsADrBDwGrIkpyEILxvZ5XEICFmuCFIyGBAJ9a0wgDSmHhhKIeUk1QtoCP3qJihyM3UAChQs1MqTQNEZDl5ywdFvSjhtltGCmB6x9JXss8CK7zJd6sqLXxWSJb7LJ2/ydnsxpUVzgZbbMVxq6dQKR8iYYfuwhZ4SBwvuGS0jv1rIcKHpnI0XBdzFfyuPfUXzHqAaG9FTwLj9/Pk/4UBmyrCgEF9R+f6UbUuyUsVusjFbG+oYTVZsYRaYDt8oFZWxsisLk/UaeQh/lbK9b7iyTZTkXva9M3os4+xrl8PacbZd9pZwhAR9EcjZDrZGRm/jBaXoSayzThsJTppfzeSeHHsXtFTwIkqH+IspTZGGmr/7HGb+gVteHjJpilEZ7JueY39+aGu0kEGrMKlL04Cu0PQnHLXI93iT1YjFdTucvFD2YyFF9N1wqVNoUBQUh+Ox6qJe7W6h27TTJV/r1ZElvislbfJdN5vlCX9BlscRV9gq6LgE23B/bV349yg5dJ2ur5/rkhsKWwmmf/C/xf1HivjgunVjp3kJ7b0xhNrpHnLVGdyCWJMIPJtqEClIomX1MZzP0ZmqbqvIVspjjNHf1kYvdiPSDuk+9bM+nbASj5faS9UGQjC+/7gz3979v+4qMLZykC56B+sV0Pp3Dodad/3cJeBe5xr4FR7//eDLCToVsD638U8y8kSWmB575Co2VsnoJ2lGtu90kjJBAarTMvdJFlpW2zTDSX6HqOvn9raEgY2WdwBaDkU7tJdUmyruGtMAq0g8oeXk9jspX6nzWPYt1/In2EeTUqpEvSOCeHofx2627BEpCTaEHMyy8z3Py/CTlzFakyfYd/PHqj6vbK0gAj7vrpJv6A55F1LZDxK27J9t1e4As34Kx6/4BAnYZ6w==
sidebar_class_name: "delete api-method"
info_path: docs/api/package
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Delete a package"}
>
</Heading>

<MethodEndpoint
  method={"delete"}
  path={"/packages/{id}"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Soft-delete a package. Its revisions are retained, so a service that points at one of them keeps resolving its bill of materials.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uuid"},"description":"The package id.","example":"1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d"}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={undefined}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"204":{"description":"The package was deleted."},"4XX":{"description":"Client error responses due to invalid input, missing parameters or insufficient permissions.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"integer","example":400},"code":{"type":"string","example":"bad_request"},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","description":"Human-readable explanation.","example":"Revision '1.4.0' exists with a different bill of materials (revision e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b)"}},"title":"errorResponse"}}}},"5XX":{"description":"Server error responses.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"integer","example":400},"code":{"type":"string","example":"bad_request"},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","description":"Human-readable explanation.","example":"Revision '1.4.0' exists with a different bill of materials (revision e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b)"}},"title":"errorResponse"}}}}}}
>
  
</StatusCodes>