# Workspaces: questions and answers

Short answers about workspaces: creating and naming them, who reaches them,
workspace members, deleting and restoring. Each answer links to the section
of [Workspaces](../organizations/workspaces.md) that owns the rule.

## The basics

### What is a workspace?

A workspace is one brand, client or business inside an organization. It has
its own files, folders and tags and its own members. The work happens
there: you always open a workspace to see files.

More: [Workspaces, Summary](../organizations/workspaces.md#summary)

### What should I make a workspace for?

One brand, client or business whose files and people you want to keep apart
from the others.

More: [Workspaces, Summary](../organizations/workspaces.md#summary)

### What does a workspace hold?

Its files with their versions, folders and tags, its uploads, its
suggestions for the organization folder, and its members.

More: [Workspaces, What a workspace holds](../organizations/workspaces.md#what-a-workspace-holds)

### How many workspaces can an organization have?

At least 1 live workspace, with no upper limit.

More: [Workspaces, Limits](../organizations/workspaces.md#limits)

### Can a workspace belong to two organizations?

No. A workspace belongs to exactly one organization.

More: [Workspaces, What a workspace holds](../organizations/workspaces.md#what-a-workspace-holds)

### Are the organization folder and the file statuses part of a workspace?

The organization folder is not: it is the organization's, with its own
folders, tags, statuses and fields. File statuses and fields are: each
workspace has its own, and the organization folder has its own.

More: [Workspaces, What a workspace holds](../organizations/workspaces.md#what-a-workspace-holds)

### Do workspaces share folders or tags with each other?

No. Each workspace has its own files, folders and tags.

More: [Workspaces, Summary](../organizations/workspaces.md#summary)

## Creating a workspace

### How do I create a workspace?

Choose "New workspace" on **Settings > Organization > Workspaces** or in
the workspace switcher, enter a "Workspace name" and choose "Create
workspace".

More: [Workspaces, Creating a workspace](../organizations/workspaces.md#creating-a-workspace)

### Who can create a workspace?

Owners and admins of the organization.

More: [Workspaces, Creating](../organizations/workspaces.md#creating)

### Can a member create a workspace?

No. A member who tries gets `403 FORBIDDEN` and nothing is created. Only
organization owners and admins create workspaces.

More: [Workspaces, Creating](../organizations/workspaces.md#creating)

### Can someone who is admin of one workspace create another workspace?

No. Creating a workspace needs the organization role owner or admin. A
plain member who is admin or owner of one workspace can rename it and
manage its members, nothing more.

More: [Workspaces, Who can do what](../organizations/workspaces.md#who-can-do-what)

### What is in a new workspace?

Nothing but three statuses. A new workspace has no files, no folders, no
tags, no custom fields and no workspace memberships. It starts with its own
statuses "Approved for public use" (allows public use), "Internal use only"
(the default for new uploads) and "Not approved".

More: [Workspaces, Creating](../organizations/workspaces.md#creating)

### Who can open a workspace right after it is created?

The organization's owners and admins. Plain members do not see a new
workspace until someone adds them to it.

More: [Workspaces, Creating](../organizations/workspaces.md#creating)

### I created a workspace and my colleague cannot see it. Why?

A new workspace has no members. Add your colleague to it, unless they are
an owner or admin of the organization.

More: [Workspaces, Creating](../organizations/workspaces.md#creating)

### Is the person who creates a workspace added as its member?

No. The creator reaches it through their organization role, like every
other owner and admin. No workspace membership is made for them.

More: [Workspaces, Creating](../organizations/workspaces.md#creating)

### Is an email sent when a workspace is created?

No. No email is sent to anyone.

More: [Workspaces, Creating](../organizations/workspaces.md#creating)

### Can I create a workspace in a deleted organization?

No. A workspace cannot be created in a deleted organization. Restore the
organization first.

More: [Workspaces, Creating](../organizations/workspaces.md#creating)

### What does the app do after I create a workspace?

It shows "{name} created". When you created it from the workspace switcher,
it also opens the new workspace.

More: [Workspaces, Creating a workspace](../organizations/workspaces.md#creating-a-workspace)

### An admin created a workspace and was later made a member. Can they still open it?

No, unless someone added them to it. Creating a workspace does not make its
creator a workspace member.

More: [Workspaces, Creating](../organizations/workspaces.md#creating)

### Why is "New workspace" missing from my workspace switcher?

"New workspace" is offered to owners and admins of the current
organization. Members do not get it.

More: [Workspaces, The workspace switcher](../organizations/workspaces.md#the-workspace-switcher)

### Do I need a verified email to create a workspace?

No. A verified email is needed only to delete a workspace.

More: [Workspaces, Who can do what](../organizations/workspaces.md#who-can-do-what)

## Workspace names

### How long can a workspace name be?

1 to 200 characters, counted after spaces at the start and end are removed.

More: [Workspaces, Naming rules](../organizations/workspaces.md#naming-rules)

### Can two workspaces have the same name?

Not in one organization. A workspace name is unique within its
organization, ignoring case. Workspaces in different organizations can have
the same name.

More: [Workspaces, Naming rules](../organizations/workspaces.md#naming-rules)

### Can "Docs" and "DOCS" both exist as workspaces in one organization?

No. Names are compared ignoring case, so the second one answers
`409 CONFLICT` with `details.reason` `NAME_TAKEN`.

More: [Workspaces, Naming rules](../organizations/workspaces.md#naming-rules)

### Why do I see "Another workspace already has this name."?

A live workspace of the organization already has that name, ignoring case.
Choose another name.

More: [Workspaces, Creating a workspace](../organizations/workspaces.md#creating-a-workspace)

### Can I reuse the name of a deleted workspace?

Yes. Only live workspaces count. The name of a deleted workspace is free
for a new workspace at once.

More: [Workspaces, Naming rules](../organizations/workspaces.md#naming-rules)

### Which characters can a workspace name contain?

Any character except control characters such as a tab or a line break.
Those are refused, also at the very end of the name.

More: [Workspaces, Naming rules](../organizations/workspaces.md#naming-rules)

### What does `409 CONFLICT` mean when I create or rename a workspace?

Another live workspace of the organization has the name. `details.reason`
is `NAME_TAKEN` and the message reads "a workspace with this name already
exists". Choose another name.

More: [Workspaces, Errors](../organizations/workspaces.md#errors)

### Are spaces around a workspace name kept?

No. Spaces at the start and end are removed before the name is measured and
stored.

More: [Workspaces, Naming rules](../organizations/workspaces.md#naming-rules)

### Why was my workspace name refused with `422 VALIDATION_FAILED`?

The name is blank after trimming, longer than 200 characters or holds a
control character such as a line break. In the app this reads "Enter a
name, up to 200 characters."

More: [Workspaces, Naming rules](../organizations/workspaces.md#naming-rules)

## Renaming a workspace

### How do I rename a workspace?

Open the workspace's settings page: **Settings > Organization >
Workspaces**, then the workspace's name. In the section "General", change
"Workspace name" and choose "Save". Afterwards the app shows "Workspace
renamed".

More: [Workspaces, Renaming a workspace](../organizations/workspaces.md#renaming-a-workspace)

### Who can rename a workspace?

Its effective owners and admins: organization owners and admins, and
members who hold the workspace role owner or admin.

More: [Workspaces, Renaming](../organizations/workspaces.md#renaming)

### Can a plain workspace member rename the workspace?

No. A member with the workspace role member gets `403 FORBIDDEN` and the
name stays.

More: [Workspaces, Renaming](../organizations/workspaces.md#renaming)

### Can I change only the capitalization of a workspace name?

Yes. A rename that only changes the case is allowed: "Other" can become
"OTHER".

More: [Workspaces, Renaming](../organizations/workspaces.md#renaming)

### Does renaming a workspace break its links or API keys?

No. A rename does not change the workspace's ID, files, members, links or
credentials.

More: [Workspaces, Renaming](../organizations/workspaces.md#renaming)

### Can I rename a deleted workspace?

No. A deleted workspace cannot be renamed. Restore it first.

More: [Workspaces, Renaming](../organizations/workspaces.md#renaming)

### What happens if two people rename the same workspace at the same moment?

Both succeed and the later name stays.

More: [Workspaces, Renaming](../organizations/workspaces.md#renaming)

### What happens if two workspaces are given the same name at the same moment?

One succeeds and the other gets `409 CONFLICT`, reason `NAME_TAKEN`.

More: [Workspaces, Renaming](../organizations/workspaces.md#renaming)

### Do I have to reload to see a workspace's new name?

No. The page, the settings navigation and the switcher show the new name
without a reload. A rename takes effect at once for everyone.

More: [Workspaces, Renaming a workspace](../organizations/workspaces.md#renaming-a-workspace)

### Why can I not change the name on a workspace's settings page?

The "Workspace name" field is there for workspaces you manage. You are a
plain member of that workspace, so the page shows the name and "Only owners
and admins of the workspace can rename it."

More: [Workspaces, Renaming a workspace](../organizations/workspaces.md#renaming-a-workspace)

### Can an organization admin who is in no workspace rename a workspace?

Yes. Admins reach every workspace through their organization role.

More: [Workspaces, Renaming](../organizations/workspaces.md#renaming)

## Who can open a workspace

### Who can open a workspace?

The organization's owners and admins, and members who have a workspace
membership for it. Nobody else.

More: [Workspaces, Who reaches which workspace](../organizations/workspaces.md#who-reaches-which-workspace)

### Do members see every workspace of the organization?

No. Members see only the workspaces they were added to. Owners and admins
see all of them.

More: [Workspaces, Who reaches which workspace](../organizations/workspaces.md#who-reaches-which-workspace)

### Do owners and admins have to be added to each workspace?

No. Organization owners reach every workspace as owner, and organization
admins reach every workspace as admin at least.

More: [Workspaces, Who reaches which workspace](../organizations/workspaces.md#who-reaches-which-workspace)

### How do I give someone access to a workspace?

If they are in the organization, open the workspace's settings page and
add them under "Members". If they are not, invite them to the organization
and tick the workspaces in the invitation.

More: [Workspaces, Workspace members in the app](../organizations/workspaces.md#workspace-members-in-the-app)

### What does someone without access get when they open a workspace?

`404 NOT_FOUND`, the same answer as for a workspace that does not exist.
They cannot tell that it exists.

More: [Workspaces, Who reaches which workspace](../organizations/workspaces.md#who-reaches-which-workspace)

### Can someone outside the workspace open one of its public files?

Yes. A file shared publicly can be opened by anyone with its link, without
reaching the workspace.

More: [Workspaces, Who reaches which workspace](../organizations/workspaces.md#who-reaches-which-workspace)

### What can I do once I can open a workspace?

Read everything in it and work with its files. What exactly each role may
do with files is in the permission matrix.

More: [Roles and permissions, Workspace files and organization folder files](../reference/permissions.md#workspace-files-and-organization-folder-files)

### Which workspaces does an API key reach?

The workspaces it was given, and only while its member can still open
them.

More: [Workspaces, Who reaches which workspace](../organizations/workspaces.md#who-reaches-which-workspace)

### Can I make a workspace that organization admins cannot open?

No. Organization owners and admins reach every workspace of the
organization. Only plain members are limited to the workspaces they are
added to.

More: [Workspaces, Who reaches which workspace](../organizations/workspaces.md#who-reaches-which-workspace)

### What can an outside freelancer reach if I add them to one workspace?

As a plain member added to one workspace, they open that workspace and work
with its files. They do not see the organization's other workspaces. Like
every member, they can read the organization's member list and its organization
folder.

More: [Workspaces, Who reaches which workspace](../organizations/workspaces.md#who-reaches-which-workspace)

### Does choosing a workspace in the app grant access to it?

No. The workspace chosen in the app is a convenience. It never grants
access.

More: [Workspaces, Who reaches which workspace](../organizations/workspaces.md#who-reaches-which-workspace)

## Workspace members

### What is a workspace membership?

It gives one organization member a role in one workspace: `owner`, `admin`
or `member`. It is how a plain member reaches a workspace at all.

More: [Workspaces, Workspace membership](../organizations/workspaces.md#workspace-membership)

### How do I add someone to a workspace?

Open the workspace's settings page and go to "Members". Under the list,
pick the person in "Choose a member", choose a role and choose "Add to
workspace". The app shows "Added {name} to {workspace}".

More: [Workspaces, Workspace members in the app](../organizations/workspaces.md#workspace-members-in-the-app)

### Who can add members to a workspace?

Its effective owners and admins: organization owners and admins, and
members with the workspace role owner or admin.

More: [Workspaces, Workspace membership](../organizations/workspaces.md#workspace-membership)

### Can I add someone who is not in the organization to a workspace?

No. Only members of the organization can be added; the API answers
`404 NOT_FOUND` for anyone else. Invite them to the organization first. An
invitation can name the workspaces they join.

More: [Workspaces, Workspace membership](../organizations/workspaces.md#workspace-membership)

### Can one person be in several workspaces with different roles?

Yes. A member can belong to any number of workspaces, with a different role
in each.

More: [Workspaces, Workspace membership](../organizations/workspaces.md#workspace-membership)

### How do I remove someone from a workspace?

Open the workspace's settings page and choose "Remove" on their row under
"Members". Confirm "Remove {name}?" with "Remove member". The app shows
"Removed {name} from {workspace}".

More: [Workspaces, Workspace members in the app](../organizations/workspaces.md#workspace-members-in-the-app)

### What happens when someone is removed from a workspace?

Their access to that workspace ends at once, unless they are an
organization owner or admin. They stay in the organization and in their
other workspaces. Files they uploaded stay.

More: [Workspaces, Workspace membership](../organizations/workspaces.md#workspace-membership)

### Does removing someone from a workspace remove them from the organization?

No. Removing a workspace membership does not remove the person from the
organization or from their other workspaces.

More: [Workspaces, Workspace membership](../organizations/workspaces.md#workspace-membership)

### Can I leave a single workspace?

Not by yourself as a plain member. There is no "leave workspace". An owner
or admin of the workspace removes you, or you leave the whole organization.

More: [Workspaces, Workspace membership](../organizations/workspaces.md#workspace-membership)

### How do I change someone's role in a workspace?

In the app, remove them from the workspace and add them again with the
other role: the section adds and removes, and does not change a role. Through
the API, `PUT /v1/workspaces/{workspaceID}/members/{userID}` with the new
role changes it in one step.

More: [Workspaces, Workspace members in the app](../organizations/workspaces.md#workspace-members-in-the-app)

### Who can make someone the owner of a workspace?

Only an effective workspace owner: an organization owner, or a member with
the workspace role owner. A workspace admin who tries gets `403 FORBIDDEN`.

More: [Workspaces, Workspace membership](../organizations/workspaces.md#workspace-membership)

### Can a workspace admin remove a workspace owner?

No. Only an effective workspace owner changes the role of a workspace owner
or removes a workspace owner's membership.

More: [Workspaces, Workspace membership](../organizations/workspaces.md#workspace-membership)

### Why is there no "Remove" button next to some people in a workspace's member list?

Either you do not manage the workspace, or the row reads "Through
organization role". Access that comes from an organization role cannot be
removed here. It is changed by changing the organization role.

More: [Workspaces, Workspace members in the app](../organizations/workspaces.md#workspace-members-in-the-app)

### What does "Through organization role" mean in a workspace's member list?

The person is an organization owner or admin and reaches the workspace
through that role, without a workspace membership.

More: [Workspaces, Workspace members in the app](../organizations/workspaces.md#workspace-members-in-the-app)

### What does "Workspace member" mean in a workspace's member list?

The person has a workspace membership for this workspace. That is the kind
of access that can be removed in this section.

More: [Workspaces, Workspace members in the app](../organizations/workspaces.md#workspace-members-in-the-app)

### What does "Every organization member already reaches this workspace." mean?

There is nobody left to add. Everyone in the organization already reaches
the workspace, so the form for adding a member is replaced by this line.

More: [Workspaces, Workspace members in the app](../organizations/workspaces.md#workspace-members-in-the-app)

### Is someone emailed when they are added to or removed from a workspace?

No. No email is sent in either case.

More: [Workspaces, Workspace membership](../organizations/workspaces.md#workspace-membership)

### What happens to a member's API key when they are removed from a workspace?

The key is not revoked, but it stops reaching that workspace and answers
`404 NOT_FOUND` there. It still reaches its other workspaces. If the member
is added again, it reaches the workspace again.

More: [Workspaces, Workspace membership](../organizations/workspaces.md#workspace-membership)

### Does it change anything to add an organization admin to a workspace?

Not while they hold that organization role. It decides what they keep if
they are later made a plain member: they then keep that workspace.

More: [Workspaces, Workspace membership](../organizations/workspaces.md#workspace-membership)

### What happens when I add someone who is already a member of the workspace?

With the same role, it succeeds and changes nothing. With another role
through the API, their role changes.

More: [Workspaces, Workspace membership](../organizations/workspaces.md#workspace-membership)

### What happens if I remove an organization admin's workspace membership?

They still open the workspace, now through their organization role. Admins
reach every workspace.

More: [Workspaces, Workspace membership](../organizations/workspaces.md#workspace-membership)

### Why do I get `404 NOT_FOUND` when I remove an organization admin from a workspace?

They have no workspace membership to remove. Their access comes from the
organization role.

More: [Workspaces, Errors](../organizations/workspaces.md#errors)

### Who appears in a workspace's member list?

Everyone who can open the workspace: the workspace members and the
organization's owners and admins, each with their effective role.

More: [Workspaces, Workspace membership](../organizations/workspaces.md#workspace-membership)

### Can a plain member see who else is in their workspace?

Yes. Everyone who can open a workspace can list its members. Each
workspace's settings page has the section "Members".

More: [Workspaces, Who can do what](../organizations/workspaces.md#who-can-do-what)

### How do I move a person from one workspace to another?

Add them to the new workspace and remove them from the old one. Both take
effect at once. There is no single "move" step.

More: [Workspaces, Workspace membership](../organizations/workspaces.md#workspace-membership)

### How many members can a workspace have?

There is no limit.

More: [Workspaces, Limits](../organizations/workspaces.md#limits)

### Which roles can I choose when I add someone to a workspace?

"Member" and "Admin", and "Owner" if you are an owner there. The choice
starts on "Member".

More: [Workspaces, Workspace members in the app](../organizations/workspaces.md#workspace-members-in-the-app)

### What does "Could not add the member. Try again." mean?

Adding the person to the workspace failed. Nothing changed. Try again. The
matching message for removal is "Could not remove the member. Try again."

More: [Workspaces, Workspace members in the app](../organizations/workspaces.md#workspace-members-in-the-app)

### What does "You" mean in a workspace's member list?

It marks your own row under "Members" on the workspace's settings page.

More: [Workspaces, Workspace members in the app](../organizations/workspaces.md#workspace-members-in-the-app)

### Can a plain workspace member add or remove other members?

No. That needs the effective role owner or admin. A workspace member who
tries gets `403 FORBIDDEN`.

More: [Workspaces, Workspace membership](../organizations/workspaces.md#workspace-membership)

### Are new members of the organization added to workspaces automatically?

No. A plain member reaches only the workspaces named in their invitation or
added afterwards. In the invite dialog, an organization's only workspace is
ticked already.

More: [Invitations, Inviting](../organizations/invitations.md#inviting)

## Deleting a workspace

### How do I delete a workspace?

Open the workspace's settings page: **Settings > Organization >
Workspaces**, then the workspace's name. Choose "Delete workspace", type
the workspace's name into "Confirm workspace name" and choose "Delete
workspace" again.

More: [Workspaces, Deleting a workspace in the app](../organizations/workspaces.md#deleting-a-workspace-in-the-app)

### Who can delete a workspace?

Organization owners and admins with a verified email address.

More: [Workspaces, Deleting a workspace](../organizations/workspaces.md#deleting-a-workspace)

### Can the owner of a single workspace delete it?

No. The organization role is what counts. A member who is owner of only
that workspace gets `403 FORBIDDEN`.

More: [Workspaces, Deleting a workspace](../organizations/workspaces.md#deleting-a-workspace)

### Why is there no "Delete workspace" on my workspace's settings page?

You are not an owner or admin of the organization, or it is the
organization's only workspace.

More: [Workspaces, A workspace's settings page](../organizations/workspaces.md#a-workspaces-settings-page)

### Why is the "Delete workspace" button disabled?

Your email address is not verified. The section says "Verify your email
before deleting a workspace." Verify it first.

More: [Workspaces, Deleting a workspace in the app](../organizations/workspaces.md#deleting-a-workspace-in-the-app)

### Do I have to type the workspace's name to delete it?

Yes. The request must repeat the workspace's name exactly as it is. "Delete
workspace" stays disabled until the name matches.

More: [Workspaces, Deleting a workspace](../organizations/workspaces.md#deleting-a-workspace)

### Does upper and lower case matter when I confirm a workspace deletion?

Yes. The comparison is exact: case and spaces count. "docs" does not
confirm the deletion of "Docs".

More: [Workspaces, Deleting a workspace](../organizations/workspaces.md#deleting-a-workspace)

### What happens the moment a workspace is deleted?

It is hidden for everyone at once. Nobody can open it, it leaves every
list, its public links stop and credentials no longer reach it. Nothing is
thrown away yet: it can be restored for 30 days.

More: [Workspaces, What deletion does at once](../organizations/workspaces.md#what-deletion-does-at-once)

### What happens to the files when a workspace is deleted?

They become unreachable at once but are kept for 30 days. If the workspace
is restored in that time, everything is back. After 30 days they are
deleted for good.

More: [Workspaces, What deletion does at once](../organizations/workspaces.md#what-deletion-does-at-once)

### Do public links keep working after a workspace is deleted?

No. Public links to its files stop working at once and answer "not found".
After a restore the same links work again.

More: [Workspaces, What deletion does at once](../organizations/workspaces.md#what-deletion-does-at-once)

### What happens to signed download links when a workspace is deleted?

Signed download links and archive links made before the deletion stop
working. After a restore they work again until they expire on their own.

More: [Workspaces, What deletion does at once](../organizations/workspaces.md#what-deletion-does-at-once)

### What happens to API keys and connected apps when a workspace is deleted?

They stay valid, but no longer list or reach the deleted workspace. Their
other workspaces keep working. After a restore they reach it again.

More: [Workspaces, What deletion does at once](../organizations/workspaces.md#what-deletion-does-at-once)

### What happens to an API key that named only the deleted workspace?

The key is still valid but reaches no workspace. After a restore it reaches
the workspace again.

More: [Workspaces, Edge cases](../organizations/workspaces.md#edge-cases)

### What happens to pending invitations that name a deleted workspace?

They no longer list it, and their emails no longer name it. An invitation
accepted while the workspace is deleted does not add the person to it. If
the workspace is restored before the invitation is accepted, the invitation
lists it again.

More: [Workspaces, What deletion does at once](../organizations/workspaces.md#what-deletion-does-at-once)

### Is a deleted workspace included in an export?

No. Exports started after the deletion leave it out, with everything in it.

More: [Workspaces, What deletion does at once](../organizations/workspaces.md#what-deletion-does-at-once)

### Are the members told when a workspace is deleted?

No. No email is sent. Someone who has it open reads "You no longer have
access to {workspace}" at their next action.

More: [Workspaces, What deletion does at once](../organizations/workspaces.md#what-deletion-does-at-once)

### Can I delete a workspace for good right away?

No. Removal for good happens after the 30 days.

More: [Workspaces, The 30-day restore window](../organizations/workspaces.md#the-30-day-restore-window)

### Can I delete the last workspace of an organization?

No. An organization keeps at least one live workspace. Create another
workspace first, or delete the whole organization.

More: [Workspaces, The last-workspace rule](../organizations/workspaces.md#the-last-workspace-rule)

### What does `LAST_WORKSPACE` mean?

You tried to delete the organization's only live workspace. The answer is
`409 CONFLICT` with `details.reason` `LAST_WORKSPACE` and the message "an
organization keeps at least one workspace".

More: [Workspaces, The last-workspace rule](../organizations/workspaces.md#the-last-workspace-rule)

### How do I replace the only workspace of an organization?

Create the new workspace first, then delete the old one.

More: [Workspaces, The last-workspace rule](../organizations/workspaces.md#the-last-workspace-rule)

### Does a deleted workspace count as a second workspace for the last-workspace rule?

No. Deleted workspaces do not count as "another workspace". With one live
and one deleted workspace, the live one cannot be deleted.

More: [Workspaces, The last-workspace rule](../organizations/workspaces.md#the-last-workspace-rule)

### What does `EMAIL_NOT_VERIFIED` mean when I delete a workspace?

The person deleting must have a verified email address, and yours is not.
Nothing is deleted. Open the verification link, or ask for a new one.

More: [Workspaces, Errors](../organizations/workspaces.md#errors)

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

The name you typed to confirm the deletion is not the workspace's name.
Check spelling, case and spaces.

More: [Workspaces, Deleting a workspace in the app](../organizations/workspaces.md#deleting-a-workspace-in-the-app)

### What does the "Delete {name}" dialog warn me about?

"Everyone loses access to it and its files at once. Owners and admins can
restore it for 30 days; after that its files are deleted for good."

More: [Workspaces, Deleting a workspace in the app](../organizations/workspaces.md#deleting-a-workspace-in-the-app)

### What does the API answer when a workspace is deleted?

`202` with the workspace's `id`, `name`, `deletedAt` and `purgeAfter`.
`purgeAfter` is 30 days after `deletedAt`.

More: [Workspaces, Deleting a workspace](../organizations/workspaces.md#deleting-a-workspace)

### In which order are the checks made when a workspace is deleted?

Sign-in first (`401`), then whether you can open the workspace (`404`),
then your organization role (`403 FORBIDDEN`), then your verified email
(`403 EMAIL_NOT_VERIFIED`), then `confirmName` (`422`), then the
last-workspace rule (`409`). The first check that fails decides the answer.

More: [Workspaces, Deleting a workspace](../organizations/workspaces.md#deleting-a-workspace)

### What happens if two admins each delete one of the last two workspaces at the same moment?

One deletion succeeds. The other is refused with `409 CONFLICT`, reason
`LAST_WORKSPACE`. The two requests are handled one after the other.

More: [Workspaces, The last-workspace rule](../organizations/workspaces.md#the-last-workspace-rule)

### What happens to a file in the trash when its workspace is deleted?

Its own trash period keeps running. When that period ends the file is
deleted for good, also while the workspace is deleted. A later restore of
the workspace comes back without it.

More: [Trash and restore, The trash and deleted workspaces](../files/trash.md#the-trash-and-deleted-workspaces)

### What happens to an upload that was still being checked when its workspace was deleted?

It is finished in the background. After a restore the file is there.

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

### Why does a plain member get `404` when deleting a workspace they are not in?

Someone who cannot open a workspace cannot tell it exists. The answer is
the same as for an unknown ID.

More: [Workspaces, Deleting a workspace](../organizations/workspaces.md#deleting-a-workspace)

### I had a workspace open and it vanished. What happened?

It was deleted, or you were removed from it. The app tells you "You no
longer have access to {workspace}" and opens another workspace you can
reach, or "No workspace yet" if there is none.

More: [Workspaces, When a workspace you have open is deleted](../organizations/workspaces.md#when-a-workspace-you-have-open-is-deleted)

### Can an owner still open the files of a deleted workspace?

No. Nobody can open it: not its members, not owners or admins, not
credentials. Every request for it or anything in it answers
`404 NOT_FOUND`. Restore it to reach the files.

More: [Workspaces, What deletion does at once](../organizations/workspaces.md#what-deletion-does-at-once)

### Can I create an API key for a deleted workspace?

No. A deleted workspace cannot be named: the answer is
`422 VALIDATION_FAILED` on `workspaceIDs`.

More: [Workspaces, What deletion does at once](../organizations/workspaces.md#what-deletion-does-at-once)

### Do the files of a deleted workspace still count in status counts or as duplicates?

No. Files elsewhere no longer name them as duplicates. The workspace's own
statuses and fields, with their counts, are out of reach with it and come
back with a restore. The organization folder and other workspaces never
counted them: each counts only its own files.

More: [Workspaces, What deletion does at once](../organizations/workspaces.md#what-deletion-does-at-once)

### What is kept while a workspace is deleted?

Every file, version, folder and tag, the workspace's statuses and fields,
every workspace membership and its role, its place in pending invitations and in API keys and connected apps,
and every public link address.

More: [Workspaces, What deletion does at once](../organizations/workspaces.md#what-deletion-does-at-once)

### What does "{name} deleted. Owners and admins can restore it until {date}." mean?

The workspace was deleted and left the list and the switcher. Until the
date shown, an owner or admin of the organization can restore it.

More: [Workspaces, Deleting a workspace in the app](../organizations/workspaces.md#deleting-a-workspace-in-the-app)

### What happens if I double-click "Delete workspace"?

The workspace is deleted once. A second request for an already deleted
workspace would answer `404 NOT_FOUND` anyway.

More: [Workspaces, Deleting a workspace in the app](../organizations/workspaces.md#deleting-a-workspace-in-the-app)

### Can a new invitation name a deleted workspace?

No. It answers `422 VALIDATION_FAILED` on `workspaceIDs`.

More: [Workspaces, What deletion does at once](../organizations/workspaces.md#what-deletion-does-at-once)

## Restoring a workspace

### Can I restore a deleted workspace?

Yes, for 30 days, as an owner or admin of the organization.

More: [Workspaces, The 30-day restore window](../organizations/workspaces.md#the-30-day-restore-window)

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

For 30 days from the deletion. The deadline is fixed at the moment of
deletion.

More: [Workspaces, The 30-day restore window](../organizations/workspaces.md#the-30-day-restore-window)

### How do I restore a deleted workspace?

Open **Settings > Organization > Workspaces**. Under "Deleted workspaces",
choose "Restore" on the workspace's row. The app shows "{name} restored".

More: [Workspaces, Restoring a workspace in the app](../organizations/workspaces.md#restoring-a-workspace-in-the-app)

### Who can restore a deleted workspace?

Organization owners and admins, until the deadline. Members cannot, also
not for a workspace they were a member of.

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

### Do I need a verified email to restore a workspace?

No. A verified email is needed to delete a workspace, not to restore one.

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

### What comes back when a workspace is restored?

Everything, as it was: the same ID and name, every file, version, folder
and tag, its statuses and fields, every workspace membership with its role, its place in pending
invitations and in API keys and connected apps, and the same public link
addresses.

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

### Do the members come back when a workspace is restored?

Yes. Every workspace membership comes back with its role.

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

### Do public links work again after a workspace is restored?

Yes. The same public link addresses work again.

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

### Does my API key reach a restored workspace without any change?

Yes. The workspace keeps its place in API keys and connected apps, and they
reach it again after the restore.

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

### What does "Another workspace is named {name} now. Rename that one, then restore this one." mean?

While the workspace was deleted, a live workspace took its name. Rename
that live workspace, then restore again. The restored workspace comes back
with its original name.

More: [Workspaces, Name conflicts on restore](../organizations/workspaces.md#name-conflicts-on-restore)

### What does `NAME_TAKEN` mean when I restore a workspace?

A live workspace has the deleted workspace's name, ignoring case. The
restore answers `409 CONFLICT` with `details.reason` `NAME_TAKEN`. The
deleted workspace stays deleted and its deadline does not move.

More: [Workspaces, Name conflicts on restore](../organizations/workspaces.md#name-conflicts-on-restore)

### Does a restore ever rename a workspace by itself?

No. A restore never renames anything by itself. It is refused until the
name is free.

More: [Workspaces, Name conflicts on restore](../organizations/workspaces.md#name-conflicts-on-restore)

### Where is the list of deleted workspaces?

On **Settings > Organization > Workspaces**, below the list of workspaces,
under "Deleted workspaces". It is shown to owners and admins as long as
there is at least one deleted workspace.

More: [Workspaces, Restoring a workspace in the app](../organizations/workspaces.md#restoring-a-workspace-in-the-app)

### Can members see deleted workspaces?

No. Members are not shown "Deleted workspaces", and asking for the list
through the API answers `403 FORBIDDEN`.

More: [Workspaces, The 30-day restore window](../organizations/workspaces.md#the-30-day-restore-window)

### What happens when the 30 days of a deleted workspace are over?

It can no longer be restored and leaves the deleted list. Shortly after, it
is removed for good: the workspace, its memberships, its files with all
their versions and stored content, its folders, tags and uploads.

More: [Workspaces, The 30-day restore window](../organizations/workspaces.md#the-30-day-restore-window)

### Does deleting a workspace again after a restore start a new 30 days?

Yes. The deadline is set at each deletion.

More: [Workspaces, Edge cases](../organizations/workspaces.md#edge-cases)

### What happens when two people restore the same workspace?

The first restore brings it back. The second gets `404 NOT_FOUND`, because
the workspace is already live. The app reports no failure: it reloads the
lists, and the workspace is under "Workspaces".

More: [Workspaces, Restoring a workspace in the app](../organizations/workspaces.md#restoring-a-workspace-in-the-app)

### Why did a workspace disappear from "Deleted workspaces" without my restoring it?

Someone else restored it, or its 30 days ended. One that was restored is
under "Workspaces". One past its 30 days is gone.

More: [Workspaces, Restoring a workspace in the app](../organizations/workspaces.md#restoring-a-workspace-in-the-app)

### Why does a member get `404` when restoring a workspace they belonged to?

Only organization owners and admins see a deleted workspace and restore it.
Nobody else learns that there is one to restore.

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

### Someone accepted an invitation while the workspace was deleted. Are they added when it is restored?

No. Accepting adds live workspaces only, and the invitation is used up. Add
them to the restored workspace by hand.

More: [Workspaces, Edge cases](../organizations/workspaces.md#edge-cases)

### What does "Could not load the deleted workspaces." mean?

The list of deleted workspaces could not be loaded. Reload the page. For a
failed restore the message is "Could not restore the workspace. Try again."

More: [Workspaces, Restoring a workspace in the app](../organizations/workspaces.md#restoring-a-workspace-in-the-app)

### Two deleted workspaces have the same name. Can I restore both?

Only one of them while it keeps that name. To restore the other, rename the
first after it is restored.

More: [Workspaces, Name conflicts on restore](../organizations/workspaces.md#name-conflicts-on-restore)

### What does a row under "Deleted workspaces" show?

The workspace's name under "Name", the date it was deleted under "Deleted",
the date it is purged under "Deleted for good on", and the button
"Restore".

More: [Workspaces, Restoring a workspace in the app](../organizations/workspaces.md#restoring-a-workspace-in-the-app)

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

The deadline until which it can be restored. It is fixed at the moment of
deletion and never shorter than 30 days.

More: [Workspaces, The 30-day restore window](../organizations/workspaces.md#the-30-day-restore-window)

### What does the API answer when a workspace is restored?

`200` with the workspace and your effective role in it. The request takes
no body.

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

### Can a workspace be restored after its deadline if it has not been removed yet?

No. At the deadline the workspace can no longer be restored, whether or not
it has been removed yet. The restore answers `404 NOT_FOUND`.

More: [Workspaces, The 30-day restore window](../organizations/workspaces.md#the-30-day-restore-window)

### Why do I get `404` when I "restore" a workspace that is not deleted?

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

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

### Is anyone emailed when a workspace is restored?

No. No email is sent.

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

### In what order are deleted workspaces listed?

Most recently deleted first, each with the date it was deleted and the date
it is removed for good.

More: [Workspaces, The 30-day restore window](../organizations/workspaces.md#the-30-day-restore-window)

### What happens to invitations and API keys that named a workspace once it is removed for good?

They stay, but no longer name it.

More: [Workspaces, The 30-day restore window](../organizations/workspaces.md#the-30-day-restore-window)

## The switcher and the Workspaces pages

### Where is the workspace switcher?

At the top of the sidebar. It lists every workspace you can open, grouped
under the name of its organization.

More: [Workspaces, The workspace switcher](../organizations/workspaces.md#the-workspace-switcher)

### What do "Choose a workspace" and "No workspace" mean in the switcher?

With no workspace open the switcher reads "Choose a workspace". It reads
"No workspace" when you have none to open.

More: [Workspaces, The workspace switcher](../organizations/workspaces.md#the-workspace-switcher)

### How do I switch workspaces from the command palette?

The command palette offers "Switch to {workspace}" for each other workspace
you can open.

More: [Workspaces, The workspace switcher](../organizations/workspaces.md#the-workspace-switcher)

### What does the Workspaces page of an organization show?

For owners and admins, every workspace of the organization. For members,
only the workspaces they can open. The table shows the workspace's name
under "Name", which opens that workspace's settings page, and your role
under "Your role".

More: [Workspaces, The Workspaces page](../organizations/workspaces.md#the-workspaces-page)

### Where are a workspace's settings?

In the settings navigation, under "File spaces":
choose the workspace and the navigation shows its own pages: "General"
under "Workspace", and "Statuses", "Custom fields" and "Tags" under "Files &
Assets". **Settings > Organization > Workspaces** links each workspace's
settings page as well.

More: [Workspaces, The settings navigation](../organizations/workspaces.md#the-settings-navigation)

### What settings does a workspace have?

Four pages. "General" has three sections: "General" with its name,
"Members", and "Delete workspace" for owners and admins of the
organization. "Statuses", "Custom fields" and "Tags" hold the workspace's
statuses, custom fields and tags.

More: [Workspaces, A workspace's settings page](../organizations/workspaces.md#a-workspaces-settings-page)

### How do I get back from a workspace's settings to the other settings?

Choose "Back" at the top of the settings navigation. It opens the
organization's General page with the main navigation, and the keyboard
focus lands on the workspace you came from.

More: [Workspaces, The settings navigation](../organizations/workspaces.md#the-settings-navigation)

### What does "Your role: {role}" on a workspace's row mean?

It is your effective role in that workspace: the stronger of your
organization role, when that is owner or admin, and your role in the
workspace.

More: [Workspaces, The Workspaces page](../organizations/workspaces.md#the-workspaces-page)

### What does "You are not a member of any workspace here yet. An owner or admin can add you to one." mean?

You belong to the organization but to none of its workspaces. Ask an owner
or admin to add you to one.

More: [Workspaces, The Workspaces page](../organizations/workspaces.md#the-workspaces-page)

### Does opening a workspace's settings switch the workspace I am working in?

No. The settings page works beside whatever workspace you have open. The
workspace switcher still names the one you are working in.

More: [Workspaces, A workspace's settings page](../organizations/workspaces.md#a-workspaces-settings-page)

### What happens if I am removed from a workspace I have open?

Your next action in it is refused. The app says "You no longer have access
to {workspace}" and takes you to another workspace you can reach.

More: [Workspaces, When a workspace you have open is deleted](../organizations/workspaces.md#when-a-workspace-you-have-open-is-deleted)

## What workspaces do not do

### Can I move a workspace to another organization?

No. A workspace belongs to exactly one organization and cannot be moved to
another.

More: [Workspaces, What a workspace holds](../organizations/workspaces.md#what-a-workspace-holds)

### Can I move files from one workspace to another?

No. A file moves only within its own workspace, or within the organization
folder. To have a file in another workspace, download it and upload it
there.

More: [Folders, moving and finding, Questions and answers](../files/organizing.md#questions-and-answers)

### Can I duplicate a workspace with its files?

No. There is no copy of a workspace. A new workspace is always empty.

More: [Workspaces, Creating](../organizations/workspaces.md#creating)

### Can I archive a workspace and keep it read-only?

No. A workspace is live, or it is deleted and restorable for 30 days.
Nobody can open a deleted workspace, so there is no read-only state.

More: [Workspaces, What deletion does at once](../organizations/workspaces.md#what-deletion-does-at-once)

### Can a workspace have a description, a color or a picture?

No. A workspace needs a name, and nothing else is asked.

More: [Workspaces, Creating](../organizations/workspaces.md#creating)

### Can a workspace have its own file statuses or fields?

Yes. Every workspace has its own statuses and fields, and the organization
folder has its own. The workspace's owners and admins, and the
organization's, manage them on the workspace's pages "Statuses" and "Custom
fields", in the workspace's own settings navigation.

More: [Workspaces, What a workspace holds](../organizations/workspaces.md#what-a-workspace-holds)

## The API and agents

### Can an agent create, rename or delete workspaces?

No. A credential can list the workspaces it reaches and read a workspace's
members. Creating, renaming, deleting and restoring workspaces and changing
their members need a person in a browser.

More: [Workspaces, For agents](../organizations/workspaces.md#for-agents)

### How does an agent list the workspaces it can reach?

With `GET /v1/workspaces`, or the MCP tool `workspaces_list`. It takes no
arguments:

```sh
curl -s "https://app.usetalewright.com/v1/workspaces" \
  -H "Authorization: Bearer $TALEWRIGHT_API_KEY"
```

More: [Workspaces, Start with `workspaces_list`](../organizations/workspaces.md#start-with-workspaces_list)

### Which scope does a credential need to list its workspaces?

Any scope. Every credential can call `workspaces.list`.

More: [Workspaces, For agents](../organizations/workspaces.md#for-agents)

### What does a workspace look like in the API?

It has `id`, `name`, `organizationID` and `organizationName`. The workspaces
in the answer for an organization, and the answers to creating, renaming
and restoring a workspace, also carry `role`: your effective role in it.

More: [Workspaces, Start with `workspaces_list`](../organizations/workspaces.md#start-with-workspaces_list)

### Can a credential read who is in a workspace?

Yes, with the scope `workspace:read`:
`GET /v1/workspaces/{workspaceID}/members`, or the MCP tool
`workspaces_members_list`.

More: [Workspaces, Reading a workspace's members](../organizations/workspaces.md#reading-a-workspaces-members)

### Why is a workspace missing from `workspaces_list`?

It cannot be reached with this credential: it was not given to it, its
member lost access, or it was deleted.

More: [Workspaces, Start with `workspaces_list`](../organizations/workspaces.md#start-with-workspaces_list)

### How many workspaces can one API key or connected app name?

1 to 20.

More: [Workspaces, Limits](../organizations/workspaces.md#limits)

### What does the API need to delete a workspace?

`DELETE /v1/workspaces/{workspaceID}` with the body
`{"confirmName": "..."}`, from a browser session. A credential gets
`403 FORBIDDEN` with `details.reason` `SESSION_REQUIRED`.

More: [Workspaces, What the session-only operations take and return](../organizations/workspaces.md#what-the-session-only-operations-take-and-return)

### How is a member added to a workspace through the API?

With `PUT /v1/workspaces/{workspaceID}/members/{userID}` and a body that
names the role, from a browser session. It answers `200` with the member
and their effective role.

More: [Workspaces, What the session-only operations take and return](../organizations/workspaces.md#what-the-session-only-operations-take-and-return)

### Is there an API operation that reads a single workspace by its ID?

No. Workspaces are read as a list: `GET /v1/workspaces` for the ones you
reach, or the `workspaces` of `GET /v1/organizations/{organizationID}`.

More: [Workspaces, For agents](../organizations/workspaces.md#for-agents)

### What does `403 FORBIDDEN` mean on a workspace operation?

You can reach the workspace, but your role does not allow the action. With
`details.reason` `SESSION_REQUIRED` it means a credential called an
operation that needs a person in a browser.

More: [Workspaces, Errors](../organizations/workspaces.md#errors)

### What does `VALIDATION_FAILED` on `confirmName` mean for a workspace?

The name sent to confirm the deletion is not the workspace's name. Nothing
is deleted. Send the current name exactly.

More: [Workspaces, Errors](../organizations/workspaces.md#errors)

### Which IDs does an agent pass to the file tools?

The workspace's `id` as `workspaceID` to the workspace tools, and
`organizationID` to the `library_` tools of the organization folder (the
API's library).

More: [Workspaces, Start with `workspaces_list`](../organizations/workspaces.md#start-with-workspaces_list)

### What happens when the workspace ID in a request is not a valid UUID?

The answer is `404 NOT_FOUND`. A malformed ID names nothing.

More: [Workspaces, Edge cases](../organizations/workspaces.md#edge-cases)

### What does the API return for the list of deleted workspaces?

`200` with `items`, each holding the workspace's `id`, `name`, `deletedAt`
and `purgeAfter`. It needs a browser session of an organization owner or
admin.

More: [Workspaces, What the session-only operations take and return](../organizations/workspaces.md#what-the-session-only-operations-take-and-return)

### What does an outsider get when asking for an organization's deleted workspaces?

`404 NOT_FOUND`. A member of the organization gets `403 FORBIDDEN`. Only
organization owners and admins see deleted workspaces.

More: [Workspaces, Edge cases](../organizations/workspaces.md#edge-cases)

### What does the API answer when a workspace is created?

`201` with the workspace: `id`, `name`, `organizationID`,
`organizationName` and `role`. The body is `{"name": "..."}`.

More: [Workspaces, What the session-only operations take and return](../organizations/workspaces.md#what-the-session-only-operations-take-and-return)
