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

Overview

This endpoint deletes an agent (bundle run) by its agt_ id. Only terminal runs can be deleted. A run that is still running or paused returns 409 — cancel it first with POST /agents/instances/{agent_id}/cancel.

Request

string
required
Agent agt_ id.

Response

Returns 204 No Content with an empty body on success.

Important Notes

  • Terminal statuses are completed, failed, and canceled. A running or paused agent must be canceled before it can be deleted.
  • Success returns 204 with no body — check the status code rather than parsing a response.