---
title: "Public Delete Runs"
method: POST
path: "/v1/runs/bulk/delete"
tags: ["V1 - Runs"]
---

# Public Delete Runs

`POST /v1/runs/bulk/delete`

## Request

- Base URL: `https://api.app.noxus.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.app.noxus.ai/v1/runs/bulk/delete`
- Auth: API key in header `X-API-Key`

Delete finished runs with everything they own (inputs and outputs, logs,
progress, traces, files no other run references). Select by ``run_ids`` or
by ``filters`` — ``filters.to_date`` deletes runs created before it. Runs
still queued, running or awaiting a human are listed under ``errors`` and
left alone. Usage analytics survive: billing is unaffected. Needs a key
carrying ``resource:delete_history``.

## Request body

- DeleteRunsRequest: Public run deletion. ``filters.to_date`` is the "older than" knob; only finished runs (completed, failed, stopped) are deleted, the rest are reported under ``errors``. ``dry_run`` only counts.
  - `run_ids` string[], nullable
  - `filters` RunFilters
    - `from_date` string, date-time, nullable
    - `to_date` string, date-time, nullable
    - `status` string, nullable
    - `source` string, nullable
    - `user_id` string, nullable
    - `workflow_id` string, uuid, nullable
    - `tags` string, nullable
    - `kb_id` string, uuid, nullable
  - `expected_count` integer, nullable
  - `dry_run` boolean

## Response `200`

Successful Response

- DeleteRunsResult
  - `succeeded` integer, required
  - `failed` integer, required
  - `errors` object, required
  - `matched` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/noxus/apis/noxus-backend.md) - [All operations](https://skmtc.dev/noxus/apis/noxus-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/noxus/apis/noxus-backend/revisions/0e37810b7ad5?raw)