# Deleting and restoring: questions and answers

Short answers about deleting an organization, the 30 days in which it can
be restored, what is removed for good afterwards, and how this combines
with deleted workspaces. Each answer links to the section of
[Deleting and restoring](../organizations/delete-and-restore.md) that owns
the rule. The details of deleting a single workspace are in
[Workspaces: questions and answers](workspaces.md).

## Deleting an organization

### How does deleting an organization work?

It goes through two stages. First it is deleted: it disappears for everyone
at once, nothing is thrown away, and for 30 days it can be restored exactly
as it was. After the 30 days it is removed for good, which cannot be
undone.

More: [Deleting and restoring, Summary](../organizations/delete-and-restore.md#summary)

### What is the difference between "deleted" and "removed for good"?

A deleted organization is hidden but complete, and an owner can restore it
for 30 days. Removed for good means everything in it is permanently
deleted.

More: [Deleting and restoring, Summary](../organizations/delete-and-restore.md#summary)

### Who can delete an organization?

Its owners, with a verified email address. Admins and members cannot.

More: [Deleting and restoring, Deleting an organization](../organizations/delete-and-restore.md#deleting-an-organization)

### How do I delete an organization?

As an owner, open **Settings > Organization > Delete organization**, type
the organization's name into "Confirm organization name" and choose "Delete
organization".

More: [Deleting and restoring, Deleting the organization](../organizations/delete-and-restore.md#deleting-the-organization)

### Do I need a verified email address to delete an organization?

Yes. The owner's email address must be verified. Otherwise the answer is
`403 EMAIL_NOT_VERIFIED` and nothing is deleted.

More: [Deleting and restoring, Deleting an organization](../organizations/delete-and-restore.md#deleting-an-organization)

### Why do I have to type the organization's name to delete it?

So that nothing is deleted by a slip. The request must repeat the name
exactly as it is, which keeps a stray request from deleting an
organization.

More: [Deleting and restoring, Deleting an organization](../organizations/delete-and-restore.md#deleting-an-organization)

### Does an organization have to be empty before I delete it?

No. It is deleted with every workspace, file and member in place.

More: [Deleting and restoring, Deleting an organization](../organizations/delete-and-restore.md#deleting-an-organization)

### Do all owners have to agree to delete an organization?

No. One owner is enough. Any owner can delete the organization, and any
owner can restore it.

More: [Deleting and restoring, Limits](../organizations/delete-and-restore.md#limits)

### Are the members told when an organization is deleted?

No. No email is sent to anyone. The organization simply disappears for
them.

More: [Deleting and restoring, Deleting an organization](../organizations/delete-and-restore.md#deleting-an-organization)

### What does "Type the organization's name exactly." mean?

The name you typed to confirm is not the organization's name. Check
spelling, upper and lower case and spaces.

More: [Deleting and restoring, Deleting the organization](../organizations/delete-and-restore.md#deleting-the-organization)

### Why does the "Delete organization" button stay disabled?

It stays disabled until "Confirm organization name" holds the name exactly.
The hint under the field shows the name to type.

More: [Deleting and restoring, Deleting the organization](../organizations/delete-and-restore.md#deleting-the-organization)

### Does upper and lower case matter when I confirm the organization's name?

Yes. The comparison is exact: upper and lower case and spaces count. "acme"
does not confirm the deletion of "Acme".

More: [Deleting and restoring, Deleting an organization](../organizations/delete-and-restore.md#deleting-an-organization)

### Does a space at the end of the typed name matter?

Yes. Nothing is trimmed. A name with a space at the end is refused with
`422 VALIDATION_FAILED` on `confirmName`.

More: [Deleting and restoring, Deleting an organization](../organizations/delete-and-restore.md#deleting-an-organization)

### The organization was renamed while I had the delete page open. Why is my name refused?

The name is compared with the current one. Reload the page and type the new
name.

More: [Deleting and restoring, Edge cases](../organizations/delete-and-restore.md#edge-cases)

### In which order are the checks made when an organization is deleted?

Sign-in (`401`), then whether the organization exists and you are a member
(`404`), then your role (`403 FORBIDDEN`), then your verified email
(`403 EMAIL_NOT_VERIFIED`), then `confirmName` (`422`). The first that
fails decides the answer.

More: [Deleting and restoring, Deleting an organization](../organizations/delete-and-restore.md#deleting-an-organization)

### Why does an admin with an unverified email get `FORBIDDEN` and not `EMAIL_NOT_VERIFIED`?

The role is checked before the email. An admin may not delete the
organization whatever their email.

More: [Deleting and restoring, Deleting an organization](../organizations/delete-and-restore.md#deleting-an-organization)

### The delete page says "Verify your email". What do I do?

Open the link in the verification email sent to your address, or choose
"Resend verification email". The page then says "Verification email sent.
Check your inbox." Nothing is deleted until you verify and try again.

More: [Deleting and restoring, Deleting the organization](../organizations/delete-and-restore.md#deleting-the-organization)

### What happens when two owners delete the organization at the same moment?

One gets `202`. The other gets `404 NOT_FOUND`, because it finds the
organization already deleted.

More: [Deleting and restoring, Edge cases](../organizations/delete-and-restore.md#edge-cases)

### What does the "Delete organization" page warn me about?

"Everyone loses access to {name} and its {n} workspaces at once. Owners can
restore it for 30 days; after that its workspaces, files and exports are
deleted for good."

More: [Deleting and restoring, Deleting the organization](../organizations/delete-and-restore.md#deleting-the-organization)

### What does the app show after I delete an organization?

"{name} deleted. Owners can restore it until {date}." The page now shows
the organization as deleted.

More: [Deleting and restoring, Deleting the organization](../organizations/delete-and-restore.md#deleting-the-organization)

### What happens if a deleted organization is deleted again?

The answer is `404 NOT_FOUND`. It is already deleted, and the deadline does
not move.

More: [Deleting and restoring, Deleting an organization](../organizations/delete-and-restore.md#deleting-an-organization)

### Can I delete an organization that has only one workspace?

Yes. The rule that an organization keeps at least one live workspace stops
you from deleting the last workspace on its own. It does not stop you from
deleting the organization.

More: [Deleting and restoring, Workspaces: the same model](../organizations/delete-and-restore.md#workspaces-the-same-model)

### Is deleting an organization the same as deleting my account?

No. Deleting an organization hides a team and its files, and can be undone
for 30 days. Deleting your account removes you as a person, at once and for
good.

More: [Deleting and restoring, Summary](../organizations/delete-and-restore.md#summary)

### Can I require a second owner to approve deleting the organization?

No. One owner confirms a deletion. To limit who can delete, limit who is an
owner. An admin can do everything an owner can except managing owners and
deleting or restoring the organization.

More: [Deleting and restoring, Limits](../organizations/delete-and-restore.md#limits)

## What stops at once

### What happens the moment I delete an organization?

Everyone loses access to the organization and all its workspaces. Public
links, API keys and connected apps stop working. Nothing is thrown away
yet.

More: [Deleting and restoring, What stops at once](../organizations/delete-and-restore.md#what-stops-at-once)

### Can an owner still open the workspaces of a deleted organization?

No. Nobody can open any workspace of the organization, owners included.
Owners keep the right to restore, not access to content.

More: [Deleting and restoring, What stops at once](../organizations/delete-and-restore.md#what-stops-at-once)

### What do admins and members see after the organization is deleted?

Nothing. The organization no longer exists for them. It leaves their lists,
and every request about it answers `404 NOT_FOUND`, the same as for an
organization that never existed.

More: [Deleting and restoring, What stops at once](../organizations/delete-and-restore.md#what-stops-at-once)

### What can an owner still do with a deleted organization?

Read it and restore it. Reading shows its name, their role and no
workspaces. Everything else is refused.

More: [Deleting and restoring, What stops at once](../organizations/delete-and-restore.md#what-stops-at-once)

### What happens to API keys and connected apps when the organization is deleted?

Every credential of the organization stops working. Requests with one
answer `401 UNAUTHENTICATED`. The credentials are not revoked: they are
suspended with the organization.

More: [Deleting and restoring, What stops at once](../organizations/delete-and-restore.md#what-stops-at-once)

### Do public links keep working during the 30 days?

No. Every public link to a file or folder of the organization stops working
at once. They work again after a restore.

More: [Deleting and restoring, What stops at once](../organizations/delete-and-restore.md#what-stops-at-once)

### What happens to download links handed out before the organization was deleted?

Signed download links and archive links handed out before the deletion stop
working.

More: [Deleting and restoring, What stops at once](../organizations/delete-and-restore.md#what-stops-at-once)

### Can anyone reach the organization folder of a deleted organization?

No. The organization folder is unreachable, like the workspaces.

More: [Deleting and restoring, What stops at once](../organizations/delete-and-restore.md#what-stops-at-once)

### Does deleting an organization sign people out?

No. Members keep their accounts, their sessions and their other
organizations.

More: [Deleting and restoring, What is kept during the 30 days](../organizations/delete-and-restore.md#what-is-kept-during-the-30-days)

### Does deleting the organization delete the members' accounts?

No. Accounts are separate. Each member keeps their account and their other
organizations.

More: [Deleting and restoring, Removal for good](../organizations/delete-and-restore.md#removal-for-good)

### Can an owner rename, invite or export while the organization is deleted?

No. Renaming, creating workspaces, inviting, changing roles, removing
members, leaving, exporting, and reading its members, invitations or
exports all answer `404 NOT_FOUND`, for owners too.

More: [Deleting and restoring, What stops at once](../organizations/delete-and-restore.md#what-stops-at-once)

### Can members be added, removed or given another role while the organization is deleted?

No. Membership of a deleted organization is frozen. Nobody can be added,
removed or given another role, and nobody can leave.

More: [Deleting and restoring, Owners while an organization is deleted](../organizations/delete-and-restore.md#owners-while-an-organization-is-deleted)

### What happens to someone who has a workspace open when the organization is deleted?

Their next action is refused. They read "You no longer have access to
{workspace}" and are taken home.

More: [Deleting and restoring, A deleted organization in the app](../organizations/delete-and-restore.md#a-deleted-organization-in-the-app)

### What happens to someone who has the organization's settings open when it is deleted?

They read "You no longer have access to {organization}" at their next
action and are taken home.

More: [Deleting and restoring, A deleted organization in the app](../organizations/delete-and-restore.md#a-deleted-organization-in-the-app)

### Where does the app take a member whose organization was deleted?

Home opens a workspace of another organization, or "Set up your
organization" when they have no other.

More: [Deleting and restoring, A deleted organization in the app](../organizations/delete-and-restore.md#a-deleted-organization-in-the-app)

### What happens to the members' other organizations when one is deleted?

Nothing. Deleting an organization touches nothing of any other
organization.

More: [Deleting and restoring, Removal for good](../organizations/delete-and-restore.md#removal-for-good)

## What is kept for 30 days

### What is kept while an organization is deleted?

Everything, exactly as it was: its name and ID, every member and role,
every workspace with its members, every file, version, folder and tag, the
statuses and fields, every public link address, pending invitations, API
keys and connected apps, and exports.

More: [Deleting and restoring, What is kept during the 30 days](../organizations/delete-and-restore.md#what-is-kept-during-the-30-days)

### Is anything thrown away at the moment an organization is deleted?

No. Nothing is deleted yet.

More: [Deleting and restoring, What is kept during the 30 days](../organizations/delete-and-restore.md#what-is-kept-during-the-30-days)

### Which clocks keep running while an organization is deleted?

Five: a pending invitation's 7 days, a ready export's 7 days, an API key's
own expiry date, the 30 days of a workspace that was deleted on its own
before, and the trash period of a file that was in the trash.

More: [Deleting and restoring, What is kept during the 30 days](../organizations/delete-and-restore.md#what-is-kept-during-the-30-days)

### Does a file's time in the trash pause while the organization is deleted?

No. A file that was in the trash still reaches the end of its own trash
period, and is then deleted for good. A restore of the organization comes
back without it.

More: [Deleting and restoring, What is kept during the 30 days](../organizations/delete-and-restore.md#what-is-kept-during-the-30-days)

### Does an API key's expiry pause while the organization is deleted?

No. An API key still expires on its own date. A key that expires during the
30 days stays expired after a restore.

More: [Deleting and restoring, What is kept during the 30 days](../organizations/delete-and-restore.md#what-is-kept-during-the-30-days)

### Is the trash of a deleted organization kept?

Yes. Every file is kept, including what was in the trash, until each
trashed file's own trash period ends.

More: [Deleting and restoring, What is kept during the 30 days](../organizations/delete-and-restore.md#what-is-kept-during-the-30-days)

### Are public link addresses kept while the organization is deleted?

Yes. Every public link address is kept, so the same links work again after
a restore.

More: [Deleting and restoring, What is kept during the 30 days](../organizations/delete-and-restore.md#what-is-kept-during-the-30-days)

## The 30-day window

### How long can I restore a deleted organization?

For 30 days from the deletion.

More: [Deleting and restoring, The restore window](../organizations/delete-and-restore.md#the-restore-window)

### Can the 30 days be extended?

No. The window cannot be extended. Restoring and deleting again starts a
new 30 days.

More: [Deleting and restoring, The restore window](../organizations/delete-and-restore.md#the-restore-window)

### Can I delete an organization for good right now?

No. The 30 days cannot be skipped or shortened. There is no way to remove
an organization for good before the deadline.

More: [Deleting and restoring, The restore window](../organizations/delete-and-restore.md#the-restore-window)

### What is `purgeAfter` on a deleted organization?

The deadline: the moment from which it can no longer be restored and is
removed for good. It is set at the moment of deletion and never sooner than
30 days after it.

More: [Deleting and restoring, The restore window](../organizations/delete-and-restore.md#the-restore-window)

### What happens at the deadline of a deleted organization?

Restoring stops being possible and the organization leaves its owners'
lists, whether or not it has been removed yet.

More: [Deleting and restoring, The restore window](../organizations/delete-and-restore.md#the-restore-window)

### Where do I see until when I can restore my organization?

On the deleted organization's page, which says on which date it and all its
files are deleted for good. In the API it is `purgeAfter`.

More: [Deleting and restoring, A deleted organization in the app](../organizations/delete-and-restore.md#a-deleted-organization-in-the-app)

### Can I get an organization back after the 30 days?

No. Removal for good cannot be undone.

More: [Deleting and restoring, Removal for good](../organizations/delete-and-restore.md#removal-for-good)

### Can the deleted organization be restored if it has not been removed yet after the deadline?

No. The window is over at the deadline, even if removal has not happened
yet. A restore answers `404 NOT_FOUND`.

More: [Deleting and restoring, The restore window](../organizations/delete-and-restore.md#the-restore-window)

## Restoring an organization

### How do I restore a deleted organization?

As an owner, open the deleted organization from the organization picker,
from **Settings > Organizations** or from the "Restore {name}" link on "Set
up your organization". Choose "Restore organization". The app shows "{name}
restored".

More: [Deleting and restoring, Restoring the organization](../organizations/delete-and-restore.md#restoring-the-organization)

### Who can restore a deleted organization?

Only an owner, and only before the deadline.

More: [Deleting and restoring, Restoring an organization](../organizations/delete-and-restore.md#restoring-an-organization)

### Does the owner who deleted the organization have to be the one who restores it?

No. Any owner may restore. It does not have to be the same person.

More: [Deleting and restoring, Who can do what](../organizations/delete-and-restore.md#who-can-do-what)

### Do I need a verified email or the typed name to restore an organization?

No. A verified email is not needed, and the name does not have to be typed.

More: [Deleting and restoring, Restoring an organization](../organizations/delete-and-restore.md#restoring-an-organization)

### What exactly comes back when an organization is restored?

Workspaces, files with their versions, folders, tags, members and roles,
statuses and fields, public links at the same addresses, API keys and
connected apps, and invitations and exports that have not expired
meanwhile.

More: [Deleting and restoring, Restoring an organization](../organizations/delete-and-restore.md#restoring-an-organization)

### Do members get their roles back when an organization is restored?

Yes. Every member has the role they had, and every workspace opens again
for the people who could open it before.

More: [Deleting and restoring, Restoring an organization](../organizations/delete-and-restore.md#restoring-an-organization)

### Do API keys work again after an organization is restored?

Yes, unless they expired meanwhile. The same credential works again without
any change.

More: [Deleting and restoring, Restoring an organization](../organizations/delete-and-restore.md#restoring-an-organization)

### Do public links work again after an organization is restored?

Yes, at the same addresses.

More: [Deleting and restoring, Restoring an organization](../organizations/delete-and-restore.md#restoring-an-organization)

### Do I have to set up members and keys again after a restore?

No. They are as they were, except for credentials or invitations whose own
expiry date passed during the deletion.

More: [Deleting and restoring, Restoring an organization](../organizations/delete-and-restore.md#restoring-an-organization)

### Can an admin restore a deleted organization?

No. Only owners restore. An admin gets `404 NOT_FOUND`, the same answer as
when they read it.

More: [Deleting and restoring, Restoring an organization](../organizations/delete-and-restore.md#restoring-an-organization)

### Why does an admin get `404` and not `403` when restoring the organization?

For its admins and members a deleted organization does not exist. The
answer is the same as for an unknown ID.

More: [Deleting and restoring, Restoring an organization](../organizations/delete-and-restore.md#restoring-an-organization)

### What does "This organization can no longer be restored." mean?

The deadline has passed. A deleted organization can be restored for 30
days, and no longer after that, whether or not it has been removed yet.

More: [Deleting and restoring, Restoring the organization](../organizations/delete-and-restore.md#restoring-the-organization)

### What does "Could not restore the organization. Try again." mean?

The restore failed for a reason other than the deadline. The organization
is still deleted. Try again.

More: [Deleting and restoring, Restoring the organization](../organizations/delete-and-restore.md#restoring-the-organization)

### What happens when two owners restore the organization at the same moment?

One gets `200`. The other gets `404 NOT_FOUND`, because it finds the
organization already live.

More: [Deleting and restoring, Edge cases](../organizations/delete-and-restore.md#edge-cases)

### Is anyone emailed when an organization is restored?

No. No email is sent.

More: [Deleting and restoring, Restoring an organization](../organizations/delete-and-restore.md#restoring-an-organization)

### Where do I find a deleted organization in the app?

As an owner: in the settings organization picker and in **Settings >
Organizations**, with the label "Deleted". Its settings navigation shows
only "General".

More: [Deleting and restoring, A deleted organization in the app](../organizations/delete-and-restore.md#a-deleted-organization-in-the-app)

### What does the page of a deleted organization show?

The name, the label "Deleted", "Your role: Owner", and the section "Restore
organization": "{name} was deleted. Nobody can open its workspaces. Unless
an owner restores it, it and all its files are deleted for good on {date}."

More: [Deleting and restoring, A deleted organization in the app](../organizations/delete-and-restore.md#a-deleted-organization-in-the-app)

### What does the API answer when an organization is restored?

`200` with the organization, live again, with `deletedAt` and `purgeAfter`
back to `null`. The request takes no body.

More: [Deleting and restoring, What the organization operations take and return](../organizations/delete-and-restore.md#what-the-organization-operations-take-and-return)

### A status started to allow public use while the organization was deleted. What happens at the restore?

Nothing became public while it was deleted. At the restore, files that are
now public get their public links.

More: [Deleting and restoring, Restoring an organization](../organizations/delete-and-restore.md#restoring-an-organization)

### Is everything still there if I restore on day 29?

Yes. A restore before the deadline is complete, and the deadline is
cleared. Only things with their own clock may be gone: expired invitations,
exports and API keys, files whose trash period ended, and a workspace that
was deleted on its own and reached its own deadline.

More: [Deleting and restoring, Edge cases](../organizations/delete-and-restore.md#edge-cases)

### Does restoring and deleting an organization again start a new 30 days?

Yes. The deadline is set at each deletion.

More: [Deleting and restoring, The restore window](../organizations/delete-and-restore.md#the-restore-window)

### Do download links from before the deletion work again after a restore?

Yes. Signed download links from before the deletion work again until they
expire on their own.

More: [Deleting and restoring, Restoring an organization](../organizations/delete-and-restore.md#restoring-an-organization)

### Why do I get `404` when I "restore" an organization that is not deleted?

Only a deleted organization can be restored. A live one answers
`404 NOT_FOUND` to a restore.

More: [Deleting and restoring, Restoring an organization](../organizations/delete-and-restore.md#restoring-an-organization)

## Removal for good

### What happens after the 30 days?

Shortly after the deadline, the organization and everything in it is
permanently deleted: workspaces, files, members' roles, invitations,
exports and credentials.

More: [Deleting and restoring, Removal for good](../organizations/delete-and-restore.md#removal-for-good)

### What exactly is removed when an organization is removed for good?

The organization itself, every membership and role, every workspace, every
file and version with the stored content, every folder, tag, upload and
organization folder suggestion, the file statuses and fields, every pending
invitation, every export and its archive, and every API key and connected
app of the organization.

More: [Deleting and restoring, Removal for good](../organizations/delete-and-restore.md#removal-for-good)

### Is anything kept after an organization is removed for good?

The members' accounts, and the audit trail entries about the organization.
No file of the organization is kept.

More: [Deleting and restoring, Removal for good](../organizations/delete-and-restore.md#removal-for-good)

### Can removal for good be stopped?

Only by restoring in time. Removal is done by Talewright when the 30 days
are over. Nobody can trigger it earlier, and nobody can stop it except by
restoring before the deadline.

More: [Deleting and restoring, Who can do what](../organizations/delete-and-restore.md#who-can-do-what)

### Do old public links work after the organization is removed for good?

No. The files no longer exist.

More: [Deleting and restoring, Edge cases](../organizations/delete-and-restore.md#edge-cases)

### Can a former member still sign in after their organization was removed for good?

Yes. Their account works. The organization is gone from it.

More: [Deleting and restoring, Removal for good](../organizations/delete-and-restore.md#removal-for-good)

### Are the audit trail entries of a removed organization deleted too?

No. Events outlive what they describe. The entries about the organization
stay.

More: [Audit trail, Rules](../reference/audit-trail.md#rules)

### Are the files of the organization folder removed with the organization?

Yes. Every file and every version is removed, in every workspace and in the
organization folder, together with the stored content.

More: [Deleting and restoring, Removal for good](../organizations/delete-and-restore.md#removal-for-good)

### What happens to an API key after its organization is removed for good?

It is gone with the organization. Nothing brings it back.

More: [Deleting and restoring, What an agent sees](../organizations/delete-and-restore.md#what-an-agent-sees)

## Owners and accounts

### I want to delete my account but I am the only owner. What do I do?

Make another member an owner, or delete the organization. Then delete your
account.

More: [Deleting and restoring, Owners while an organization is deleted](../organizations/delete-and-restore.md#owners-while-an-organization-is-deleted)

### What if the only owner deletes their account while the organization is deleted?

It is allowed, on purpose. Nobody is then left who can restore the
organization, and it is removed for good at its deadline.

More: [Deleting and restoring, Owners while an organization is deleted](../organizations/delete-and-restore.md#owners-while-an-organization-is-deleted)

### One of two owners deleted their account while the organization was deleted. Can it still be restored?

Yes. The other owner can still restore it.

More: [Deleting and restoring, Owners while an organization is deleted](../organizations/delete-and-restore.md#owners-while-an-organization-is-deleted)

### An admin deleted their account while the organization was deleted. Are they a member after the restore?

No. Account deletion removes every membership, also in a deleted
organization.

More: [Deleting and restoring, Edge cases](../organizations/delete-and-restore.md#edge-cases)

### Does deleting my organization let me delete my account afterwards?

Yes. An owner cannot delete their account while they are the only owner of
a live organization. Deleting that organization first is one way to make
account deletion possible, and it is allowed on purpose. The organization is
then purged when its 30 days end, and nobody can restore it.

More: [Deleting and restoring, Owners while an organization is deleted](../organizations/delete-and-restore.md#owners-while-an-organization-is-deleted)

### Can I create a new organization while mine is deleted?

Yes. An owner whose only organization is deleted can restore it and can
also create a new organization.

More: [Deleting and restoring, Edge cases](../organizations/delete-and-restore.md#edge-cases)

### Can I reuse the name of a deleted organization for a new one?

Yes, at any time. Organization names are not unique. Both exist, with
different IDs.

More: [Deleting and restoring, Edge cases](../organizations/delete-and-restore.md#edge-cases)

## Organizations and workspaces together

### What is the difference between deleting a workspace and deleting the organization?

A workspace deletion hides one workspace and its files; owners and admins
can do and undo it. An organization deletion hides everything; only owners
can do and undo it.

More: [Deleting and restoring, Workspaces: the same model](../organizations/delete-and-restore.md#workspaces-the-same-model)

### How is deleting an organization different from the trash for files?

The trash holds single files and folders inside a live workspace. Deleting
a workspace or an organization hides everything in it at once, trash
included.

More: [Deleting and restoring, Questions and answers](../organizations/delete-and-restore.md#questions-and-answers)

### I deleted a workspace earlier. Does restoring the organization bring it back?

No. A workspace that had been deleted on its own stays in the list of
deleted workspaces with its own deadline. Restore it separately, within its
own 30 days.

More: [Deleting and restoring, Restoring an organization](../organizations/delete-and-restore.md#restoring-an-organization)

### Can I restore a deleted workspace while its organization is deleted?

No. It answers `404 NOT_FOUND`. Restore the organization first.

More: [Deleting and restoring, Workspaces: the same model](../organizations/delete-and-restore.md#workspaces-the-same-model)

### What happens to a deleted workspace when its organization is removed for good?

It goes with the organization, whatever its own deadline was.

More: [Deleting and restoring, Workspaces: the same model](../organizations/delete-and-restore.md#workspaces-the-same-model)

### Does deleting or restoring the organization move the deadline of a deleted workspace?

No. A workspace that was already deleted keeps its own deadline.

More: [Deleting and restoring, Workspaces: the same model](../organizations/delete-and-restore.md#workspaces-the-same-model)

### A deleted workspace's deadline passes while the organization is deleted. What happens?

The workspace is removed for good on its own. A later restore of the
organization comes back without it.

More: [Deleting and restoring, Workspaces: the same model](../organizations/delete-and-restore.md#workspaces-the-same-model)

### Which workspaces come back when an organization is restored?

The workspaces that were live when it was deleted.

More: [Deleting and restoring, Workspaces: the same model](../organizations/delete-and-restore.md#workspaces-the-same-model)

### How do credentials behave for a deleted workspace compared with a deleted organization?

For a deleted workspace they stay valid but cannot reach that workspace.
For a deleted organization all of its credentials answer `401`.

More: [Deleting and restoring, Workspaces: the same model](../organizations/delete-and-restore.md#workspaces-the-same-model)

### Is the restore window the same for a workspace and an organization?

Yes. Both are 30 days from the deletion.

More: [Deleting and restoring, Limits](../organizations/delete-and-restore.md#limits)

## Mistakes and recovery

### I deleted the wrong organization. How do I get it back?

Restore it within 30 days. Any owner can, and everything comes back as it
was.

More: [Deleting and restoring, Restoring an organization](../organizations/delete-and-restore.md#restoring-an-organization)

### I deleted the wrong workspace by mistake. Is anything lost?

No, as long as an owner or admin restores it within 30 days. Every file,
member, role, public link address and credential that named it is kept for
the restore. One exception: a file that was already in the trash keeps its
own trash period, and is deleted for good when that ends.

More: [Workspaces, Restoring](../organizations/workspaces.md#restoring)

### An owner deleted the organization without asking. Can another owner undo it?

Yes. Any owner can restore it within the 30 days. A different owner may
restore than the one who deleted.

More: [Deleting and restoring, Who can do what](../organizations/delete-and-restore.md#who-can-do-what)

### I deleted an organization and created a new one with the same name. Can I still restore the old one?

Yes. Both exist, with different IDs. A restore of an organization is never
refused for its name.

More: [Deleting and restoring, Edge cases](../organizations/delete-and-restore.md#edge-cases)

## The API and agents

### Can an agent delete or restore an organization or a workspace?

No. No delete or restore operation is open to a credential, and none is an
MCP tool. A credential gets `403 FORBIDDEN` with `details.reason`
`SESSION_REQUIRED`.

More: [Deleting and restoring, For agents](../organizations/delete-and-restore.md#for-agents)

### My API key suddenly answers `401`. Was the organization deleted?

Possibly. A deleted organization, a revoked key and an expired key all
answer the same. Ask an owner.

More: [Deleting and restoring, What an agent sees](../organizations/delete-and-restore.md#what-an-agent-sees)

### What does an agent see when its organization is deleted?

Every request with its credential answers `401 UNAUTHENTICATED` with
`details.reason` `INVALID_TOKEN`. The agent cannot tell this apart from a
revoked or expired credential.

More: [Deleting and restoring, What an agent sees](../organizations/delete-and-restore.md#what-an-agent-sees)

### What should an agent do when it meets `401` or a missing workspace?

Stop and tell the person it works for. It must not retry in a loop.

More: [Deleting and restoring, What an agent sees](../organizations/delete-and-restore.md#what-an-agent-sees)

### What does an agent see when one of its workspaces is deleted?

The credential keeps working. The workspace is missing from
`workspaces_list`, and requests for it answer `404 NOT_FOUND`. After a
restore it is back.

More: [Deleting and restoring, What an agent sees](../organizations/delete-and-restore.md#what-an-agent-sees)

### What does the API take and return when an organization is deleted?

`DELETE /v1/organizations/{organizationID}` takes `confirmName` and answers
`202` with `purgeAfter`, the moment the organization is removed for good.

More: [Deleting and restoring, What the organization operations take and return](../organizations/delete-and-restore.md#what-the-organization-operations-take-and-return)

### What does an owner read for a deleted organization through the API?

Its `id`, `name`, `role` `owner`, `createdAt`, `deletedAt`, `purgeAfter`,
and an empty `workspaces` list.

More: [Deleting and restoring, What the organization operations take and return](../organizations/delete-and-restore.md#what-the-organization-operations-take-and-return)

### What does `EMAIL_NOT_VERIFIED` mean when I delete an organization?

Deleting needs a verified email address, and yours is not verified. The
message reads "Verify your email address first". Open the verification
link, or ask for a new one.

More: [Deleting and restoring, Errors](../organizations/delete-and-restore.md#errors)

### What does `VALIDATION_FAILED` on `confirmName` mean for an organization?

`confirmName` is missing or is not the exact current name. The message
reads "confirmName must be the organization's name". Type the current name
exactly.

More: [Deleting and restoring, Errors](../organizations/delete-and-restore.md#errors)

### Why do I get `404 NOT_FOUND` when I delete an organization?

The organization is unknown or already deleted, or you are not a member of
it. Outsiders cannot tell it exists.

More: [Deleting and restoring, Deleting an organization](../organizations/delete-and-restore.md#deleting-an-organization)

### Which delete and restore operations does the API have?

Five, all for a browser session: delete and restore an organization, delete
and restore a workspace, and list an organization's deleted workspaces.

More: [Deleting and restoring, For agents](../organizations/delete-and-restore.md#for-agents)

### Is deleting or restoring an organization recorded in the audit trail?

Yes. `organization.deleted` and `organization.restored` are recorded for
the owner who did it, and `organization.purged` by the system when the
organization is removed for good.

More: [Audit trail, Organizations and workspaces](../reference/audit-trail.md#organizations-and-workspaces)

### What happens when an owner deletes the organization while an admin is creating a workspace?

The two are handled one after the other. Either the workspace is created
and then hidden with the organization, or the creation gets
`404 NOT_FOUND`. A workspace is never added to a deleted organization.

More: [Deleting and restoring, Edge cases](../organizations/delete-and-restore.md#edge-cases)

### What does `403 FORBIDDEN` mean when I delete an organization?

You are an admin or member of the organization. Only owners delete it.
Nothing changes. Ask an owner.

More: [Deleting and restoring, Errors](../organizations/delete-and-restore.md#errors)
