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

Overview

This endpoint deletes a package by its pkg_ id. The blueprint it held is untouched. A run keeps the package it came from for its whole history, so a package that agents have been run from returns 409. List those runs with List Agents and package_id, delete them, then delete the package.

Request

string
required
Package pkg_ id.

Response

Returns 204 No Content with an empty body on success.

Important Notes

  • A 409 means agents have been run from the package. Delete those runs first; the message links the List Agents query that finds them.
  • Outside a project, a user who is not an org admin lists only their own runs. If other users’ runs block the delete, the 409 message says so, and their owner or an org admin must delete them.
  • A 403 means you can see the package’s project but cannot modify it.
  • A 404 means the package does not exist, belongs to another organization, or is in a project you cannot see.
  • Success returns 204 with no body. Check the status code rather than parsing a response.