All docs
AdministrationDelete a projectdashboard

Delete a project

Permanently delete a project and everything in it — what is removed, what is kept, what your apps see, and what to export first.

What you'll have

A project removed for good, with what you need exported first and no app left calling a dead key.

You'll need
  • The Owner role in your organisation

Deleting a project permanently removes it and everything in it, and revokes its API keys at once. Only an organisation Owner can do it, and it cannot be undone — so export what you want to keep first.

What changed (16 Nov 2026): deleting a project now permanently removes all of its data and revokes its API keys immediately. Before, a deleted project was only hidden.

What is deleted, and what is kept

Deleted, permanentlyKept
Every answer and trace, with its scores, claim checks, check results and verdict historyYour organisation, its members and its other projects
Sessions and hand-offsUsage and billing for the period: evaluations already used still count, as daily totals for the organisation, with no prompts, answers or scores
Datasets, their items, and every run and release-gate resultA record of the deletion: who deleted which project, when, and how many records were removed
Human reviews, alerts and their history, collection rulesAnything you exported before deleting
The evaluation policy, all its versions and its history, data definitions
Experiments, prompts, feature flags and gates, and environments of the project
The project's API keys — revoked at once

Answers sent but not yet scored when you delete are dropped, not scored.

Before you delete: export what you need

  1. Answers — in Live events, filter to what you want and click Export shown rows (CSV).
  2. Datasets — open each dataset and click Export items.
  3. Policy — open Evaluation policy › Advanced settings › YAML and copy the version; you can apply it in another project's YAML tab later.
  4. Apps — move every app and CI job that uses this project's API keys to a key in another project. Their calls fail the moment you delete.

Delete it

Delete projectDelete project

  1. Switch to the project in the project switcher.
  2. Open Administration › Project configuration › Delete project.
  3. Read the summary: it names the project and what will be deleted.
  4. Type the project name exactly, including capitals and spaces. Delete project permanently stays disabled until it matches — and for anyone who is not an Owner, with the reason shown beside it.
  5. Click Delete project permanently. It shows Deleting…, then takes you to another of your projects, or to creating a new one if it was the last.

What your apps see afterwards

The keys are revoked in the same step, so the next call with one is refused. log() and the settings calls raise:

from variably import VariablyClient
from variably.errors import AuthenticationError

try:
    client.log(question, answer, reference_materials=docs)
except AuthenticationError as e:
    print(e)            # Unauthorized: Invalid API key

observe() and the framework integrations don't raise into your app: they log the error and the answer is not recorded. An MLflow import stops at the first authentication error. OpenTelemetry exports are refused and dropped in the background. Put a key from another project in VARIABLY_API_KEY and restart the app.

If the delete is refused

Nothing is deleted in either case; fix the cause and try again.

MessageWhyWhat to do
the project cannot be deleted: rows of another project reference it (…); nothing was deletedAnother project uses something of this one, such as a prompt version or a feature gateRemove that use in the other project, then delete again. Ask us if you can't find it
the project is busy (another write holds its rows); nothing was deleted, try againAnswers were being written at that momentTry again in a few seconds; pause the app's traffic if it keeps happening

Troubleshooting

You seeWhyFix
I deleted a project by mistakeDeleting is permanentIt cannot be restored. Create a new project and key, re-create datasets from their export, apply the policy YAML you copied, and point your apps at the new key
An app fails with AuthenticationError: UnauthorizedIts key belonged to a deleted projectCreate a key in the project the app should log to and update VARIABLY_API_KEY
Delete project permanently stays disabledYou are not an Owner, or the typed name doesn't match exactlyAsk an Owner, or type the name exactly as shown

FAQ

Can a deleted project be restored by support? No. The data is removed, not hidden.

Does deleting a project lower this month's bill? No. Evaluations already used still count toward the period's usage; the project simply stops using more.

Can I delete only old answers and keep the project? Not from this page — deleting a project removes everything in it.

Is the deletion recorded? Yes. Your organisation keeps a record of who deleted which project, when, and how many records were removed. It holds no answers or scores.


Concepts on this page: Integrations, data and usage