Skip to main content
DELETE
Requires version 1.1.9 or later of the Archetype platform.

Overview

This endpoint deletes a blueprint, addressed either by its blp_ id or by its key. A blueprint that anything still holds, such as a package, eval or optimization, cannot be deleted. Delete those first.

Request

string
required
Blueprint blp_ id or key (e.g. osm).
string
The prj_ id of the project to resolve a key in, as well as outside projects. Needed for a key registered in a project; ignored for a blp_ id. v2.0.0+

Response

Returns 204 No Content with an empty body on success.

Important Notes

  • Deleting a blueprint requires the admin role; deleting a canonical blueprint requires super-admin. A blueprint in a project can instead be deleted by anyone who can modify the project, and a 403 then means you have read-only access to the project. v2.0.0+
  • A key registered in a project resolves only when project_id names that project. v2.0.0+
  • A 409 means something still holds this blueprint. When it is packages, evals or optimizations, the message names them and the list query that finds them; delete those first. Starting with version 2.0.1, bundles no longer hold blueprints, and anything else gets Blueprint '<id>' is still referenced; delete what holds it first.
  • Success returns 204 with no body — check the status code rather than parsing a response.