Skip to main content
DELETE
Requires version 1.1.9 or later of the Archetype platform.
Starting with version 2.0.1, this endpoint is removed from the platform. Use Delete Session instead. To move existing code, see Migrating from Bundles and Instances.

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 an HTTP 409 status code; cancel it first with Cancel Agent.

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 cancelled. A running or paused agent must be cancelled before it can be deleted.
  • Success returns 204 with no body — check the status code rather than parsing a response.