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 that owns the rule.
The basics
Creating a workspace
- How do I create a workspace?
- Who can create a workspace?
- Can a member create a workspace?
- Can someone who is admin of one workspace create another workspace?
- What is in a new workspace?
- Who can open a workspace right after it is created?
- I created a workspace and my colleague cannot see it. Why?
- Is the person who creates a workspace added as its member?
- Is an email sent when a workspace is created?
- Can I create a workspace in a deleted organization?
- What does the app do after I create a workspace?
- An admin created a workspace and was later made a member. Can they still open it?
- Why is "New workspace" missing from my workspace switcher?
- Do I need a verified email to create a workspace?
Workspace names
- How long can a workspace name be?
- Can two workspaces have the same name?
- Can "Docs" and "DOCS" both exist as workspaces in one organization?
- Why do I see "Another workspace already has this name."?
- Can I reuse the name of a deleted workspace?
- Which characters can a workspace name contain?
- What does
409 CONFLICTmean when I create or rename a workspace? - Are spaces around a workspace name kept?
- Why was my workspace name refused with
422 VALIDATION_FAILED?
Renaming a workspace
- How do I rename a workspace?
- Who can rename a workspace?
- Can a plain workspace member rename the workspace?
- Can I change only the capitalization of a workspace name?
- Does renaming a workspace break its links or API keys?
- Can I rename a deleted workspace?
- What happens if two people rename the same workspace at the same moment?
- What happens if two workspaces are given the same name at the same moment?
- Do I have to reload to see a workspace's new name?
- Why can I not change the name on a workspace's settings page?
- Can an organization admin who is in no workspace rename a workspace?
Who can open a workspace
- Who can open a workspace?
- Do members see every workspace of the organization?
- Do owners and admins have to be added to each workspace?
- How do I give someone access to a workspace?
- What does someone without access get when they open a workspace?
- Can someone outside the workspace open one of its public files?
- What can I do once I can open a workspace?
- Which workspaces does an API key reach?
- Can I make a workspace that organization admins cannot open?
- What can an outside freelancer reach if I add them to one workspace?
- Does choosing a workspace in the app grant access to it?
Workspace members
- What is a workspace membership?
- How do I add someone to a workspace?
- Who can add members to a workspace?
- Can I add someone who is not in the organization to a workspace?
- Can one person be in several workspaces with different roles?
- How do I remove someone from a workspace?
- What happens when someone is removed from a workspace?
- Does removing someone from a workspace remove them from the organization?
- Can I leave a single workspace?
- How do I change someone's role in a workspace?
- Who can make someone the owner of a workspace?
- Can a workspace admin remove a workspace owner?
- Why is there no "Remove" button next to some people in a workspace's member list?
- What does "Through organization role" mean in a workspace's member list?
- What does "Workspace member" mean in a workspace's member list?
- What does "Every organization member already reaches this workspace." mean?
- Is someone emailed when they are added to or removed from a workspace?
- What happens to a member's API key when they are removed from a workspace?
- Does it change anything to add an organization admin to a workspace?
- What happens when I add someone who is already a member of the workspace?
- What happens if I remove an organization admin's workspace membership?
- Why do I get
404 NOT_FOUNDwhen I remove an organization admin from a workspace? - Who appears in a workspace's member list?
- Can a plain member see who else is in their workspace?
- How do I move a person from one workspace to another?
- How many members can a workspace have?
- Which roles can I choose when I add someone to a workspace?
- What does "Could not add the member. Try again." mean?
- What does "You" mean in a workspace's member list?
- Can a plain workspace member add or remove other members?
- Are new members of the organization added to workspaces automatically?
Deleting a workspace
- How do I delete a workspace?
- Who can delete a workspace?
- Can the owner of a single workspace delete it?
- Why is there no "Delete workspace" on my workspace's settings page?
- Why is the "Delete workspace" button disabled?
- Do I have to type the workspace's name to delete it?
- Does upper and lower case matter when I confirm a workspace deletion?
- What happens the moment a workspace is deleted?
- What happens to the files when a workspace is deleted?
- Do public links keep working after a workspace is deleted?
- What happens to signed download links when a workspace is deleted?
- What happens to API keys and connected apps when a workspace is deleted?
- What happens to an API key that named only the deleted workspace?
- What happens to pending invitations that name a deleted workspace?
- Is a deleted workspace included in an export?
- Are the members told when a workspace is deleted?
- Can I delete a workspace for good right away?
- Can I delete the last workspace of an organization?
- What does
LAST_WORKSPACEmean? - How do I replace the only workspace of an organization?
- Does a deleted workspace count as a second workspace for the last-workspace rule?
- What does
EMAIL_NOT_VERIFIEDmean when I delete a workspace? - What does "Type the workspace's name exactly." mean?
- What does the "Delete {name}" dialog warn me about?
- What does the API answer when a workspace is deleted?
- In which order are the checks made when a workspace is deleted?
- What happens if two admins each delete one of the last two workspaces at the same moment?
- What happens to a file in the trash when its workspace is deleted?
- What happens to an upload that was still being checked when its workspace was deleted?
- Why does a plain member get
404when deleting a workspace they are not in? - I had a workspace open and it vanished. What happened?
- Can an owner still open the files of a deleted workspace?
- Can I create an API key for a deleted workspace?
- Do the files of a deleted workspace still count in status counts or as duplicates?
- What is kept while a workspace is deleted?
- What does "{name} deleted. Owners and admins can restore it until {date}." mean?
- What happens if I double-click "Delete workspace"?
- Can a new invitation name a deleted workspace?
Restoring a workspace
- Can I restore a deleted workspace?
- How long can I restore a deleted workspace?
- How do I restore a deleted workspace?
- Who can restore a deleted workspace?
- Do I need a verified email to restore a workspace?
- What comes back when a workspace is restored?
- Do the members come back when a workspace is restored?
- Do public links work again after a workspace is restored?
- Does my API key reach a restored workspace without any change?
- What does "Another workspace is named {name} now. Rename that one, then restore this one." mean?
- What does
NAME_TAKENmean when I restore a workspace? - Does a restore ever rename a workspace by itself?
- Where is the list of deleted workspaces?
- Can members see deleted workspaces?
- What happens when the 30 days of a deleted workspace are over?
- Does deleting a workspace again after a restore start a new 30 days?
- What happens when two people restore the same workspace?
- Why did a workspace disappear from "Deleted workspaces" without my restoring it?
- Why does a member get
404when restoring a workspace they belonged to? - Someone accepted an invitation while the workspace was deleted. Are they added when it is restored?
- What does "Could not load the deleted workspaces." mean?
- Two deleted workspaces have the same name. Can I restore both?
- What does a row under "Deleted workspaces" show?
- What is
purgeAfteron a deleted workspace? - What does the API answer when a workspace is restored?
- Can a workspace be restored after its deadline if it has not been removed yet?
- Why do I get
404when I "restore" a workspace that is not deleted? - Is anyone emailed when a workspace is restored?
- In what order are deleted workspaces listed?
- What happens to invitations and API keys that named a workspace once it is removed for good?
The switcher and the Workspaces pages
- Where is the workspace switcher?
- What do "Choose a workspace" and "No workspace" mean in the switcher?
- How do I switch workspaces from the command palette?
- What does the Workspaces page of an organization show?
- Where are a workspace's settings?
- What settings does a workspace have?
- How do I get back from a workspace's settings to the other settings?
- What does "Your role: {role}" on a workspace's row mean?
- What does "You are not a member of any workspace here yet. An owner or admin can add you to one." mean?
- Does opening a workspace's settings switch the workspace I am working in?
- What happens if I am removed from a workspace I have open?
What workspaces do not do
The API and agents
- Can an agent create, rename or delete workspaces?
- How does an agent list the workspaces it can reach?
- Which scope does a credential need to list its workspaces?
- What does a workspace look like in the API?
- Can a credential read who is in a workspace?
- Why is a workspace missing from
workspaces_list? - How many workspaces can one API key or connected app name?
- What does the API need to delete a workspace?
- How is a member added to a workspace through the API?
- Is there an API operation that reads a single workspace by its ID?
- What does
403 FORBIDDENmean on a workspace operation? - What does
VALIDATION_FAILEDonconfirmNamemean for a workspace? - Which IDs does an agent pass to the file tools?
- What happens when the workspace ID in a request is not a valid UUID?
- What does the API return for the list of deleted workspaces?
- What does an outsider get when asking for an organization's deleted workspaces?
- What does the API answer when a workspace is created?