---
search:
  tags:
    - Actions
    - DELETE
seo:
  description: >-
    Archive an action. It stops resolving and its name becomes free to reuse,
    while… Reference for the DELETE /api/v2/actions/{ref} endpoint in the Anlyon
    API.
sidebar:
  label: Delete an action
  badge: DELETE
title: Delete an action
type: openapi-operation
---
Archive an action. It stops resolving and its name becomes free to reuse, while its immutable versions and its invocation history are retained -- an agent version may pin one of those versions, and destroying them would dismantle rollback and erase the audit trail in the same call. Archiving an action that currently requires approval additionally needs `actions:govern`, because removing a gate is removing a gate whichever verb gets you there.

`DELETE /api/v2/actions/{ref}`