Delete one finished run
Requires scope
run:manageDeletes a TERMINAL run (completed, failed or cancelled) together with its step rows and its offloaded step payloads. Deletion is permanent and there is no undo.
A run that is pending, running or paused is REFUSED with 409 — cancel it first (POST /api/runs/{id}/cancel), then delete it, so no executor or resume job is orphaned.
Authorization
bearerAuth AuthorizationBearer <token>
An API token: Authorization: Bearer grt_…. Mint one in the app under Settings → Workspace → API tokens; the raw value is shown once. Scopes confine the token — see x-permission on each operation.
In: header
Path Parameters
id*string
The run id (UUID).
Format
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/api/runs/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "data": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "deleted": true }}