---
title: "Delete run"
method: DELETE
path: "/v1/projects/{project_id}/runs/{run_id}"
tags: ["runs"]
---

# Delete run

`DELETE /v1/projects/{project_id}/runs/{run_id}`

## Request

- Base URL: `https://api.connic.co`
- URL: `https://api.connic.co/v1/projects/{project_id}/runs/{run_id}`
- Auth: HTTP bearer

Deletes the run's input, output, error, run context and execution trace, and the reasoning of judge evaluations of it. Status, timing, token usage, cost and judge scores remain, and `data_deleted_at` is set. Returns 409 until the run and its background processing have finished; an already-deleted run returns `deleted_count: 0`. This cannot be undone.

Required permission: `runs.delete`.

## Path parameters

- `project_id` string, uuid, required
- `run_id` string, uuid, required

## Response `200`

Successful Response

- PublicRunDataDeleteResponse
  - `ok` boolean, required: Whether the operation succeeded.
  - `deleted_count` integer, required: Number of runs deleted. Runs that were already deleted are not counted.

## Other responses

- `401`: Missing or invalid API key.
- `403`: The API key lacks the required permission or access to the environment.
- `404`: The resource does not exist in this project.
- `422`: Validation Error
- `429`: Rate limit exceeded.

---

[API](https://skmtc.dev/connic/apis/connic-api.md) · [All operations](https://skmtc.dev/connic/apis/connic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/connic/apis/connic-api/revisions/482932da5fbe?raw)
