File statuses and approval: questions and answers
Short answers about file statuses: the three starting statuses, adding, renaming, ordering and deleting them, "allows public use", the status new uploads get, who sets a status, setting one on many files, what a status change does to public links, filtering, counts and approval workflows. Each answer links to the section of Statuses that owns the rule.
The basics
- What is a file status in Talewright?
- Why does a file's status matter for sharing?
- Do the organization folder and the workspaces use the same statuses?
- Can a file carry a status of another workspace or of the organization folder?
- Can a file have more than one status?
- Can a file have no status at all?
- Do folders have a status?
- Is the status one of the custom fields?
- Who can see a file's status?
- Can someone outside the organization read its status list?
- Can a status of one organization be used on files of another?
- Where is the status list in the app?
- What is the address of the status settings page?
- What does each row of the "Statuses" table in settings show?
- Is anyone notified when a file's status changes?
- Which audit events record changes to statuses?
- Can the status list of a workspace or the organization folder be empty?
The three starting statuses
- Which statuses does a new workspace or organization folder start with?
- What does the status "Approved for public use" do?
- What does the status "Internal use only" do?
- What does the status "Not approved" do?
- Which of the starting statuses allows public use?
- Can I rename the three starting statuses?
- Can I delete "Approved for public use", "Internal use only" or "Not approved"?
- Does the name of a status decide what it does?
Adding a status
- How do I add a status?
- Who can add a status?
- Can a member add, rename or delete a status?
- Can a workspace admin who is a plain member of the organization manage the status list?
- Why is there no "Add status" button on my settings page?
- What does a new status need?
- Where does a new status go in the list?
- Is a new status the default for new uploads?
- What does the checkbox "Allows public use" in the "Add status" dialog mean?
- Why does the "Add status" dialog say "Enter a name of 1 to 60 characters."?
- Why does the "Add status" dialog say "Another status has that name."?
- How do I make room for a new status when the list is full?
- Why does adding a status with an API key answer
SESSION_REQUIRED? - What does the API answer when a status is added?
- In what order is a request to add a status checked?
Status names
- Can a status name contain a tab or a line break?
- Are spaces at the start or end of a status name kept?
- Can a status have an empty name?
- Can "Licensed" and "licensed" both exist as statuses?
- Can two workspaces, or two organizations, use the same status names?
- Can I reuse the name of a deleted status?
- Why was my status name refused with
422 VALIDATION_FAILEDonname? - What does
NAME_TAKENmean when I add or rename a status?
Renaming a status
- How do I rename a status?
- Who can rename a status?
- Does renaming a status change the files that have it?
- Does renaming a status start or stop any public link?
- Does a renamed status keep its ID and its place in the list?
- Can I change only the capital letters of a status name?
- Can one request rename a status and change its other settings?
- What happens when one part of a combined status change is refused?
The order of the statuses
- How do I change the order of the statuses?
- Who can reorder the statuses?
- Where does the order of the statuses show?
- Does reordering statuses change any file or public link?
- Why is there no "Move up" on the first status?
- How does a reorder request name the new order of statuses?
- Why did my reorder fail after a colleague added a status?
- How are the positions of statuses numbered?
Allows public use
- What does "allows public use" mean on a status?
- Does a status that allows public use make its files public?
- What do "Public use" and "No public use" mean beside a status?
- How do I let an existing status allow public use?
- How do I stop a status from allowing public use?
- Who can change whether a status allows public use?
- What happens to public files when their status stops allowing public use?
- What does "3 public links will stop working. Allowing public use again brings back only the links of files in public folders." mean?
- What does "No file with it is public. Its files can no longer be shared publicly." mean?
- If I allow public use on a status again, do the stopped links come back?
- Why does "Allow public use" on a status ask "Change who can open these files?" first?
- Does the API ask before a status starts allowing public use?
- Does the API ask before a status stops allowing public use?
- Can more than one status allow public use?
The status for new uploads
- What is the default status?
- Which status does a newly uploaded file get?
- What does "New uploads" mean beside a status in settings?
- How do I change which status new uploads get?
- What does "Stop using for new uploads" do?
- What happens to the old default when I make another status the default?
- Can a workspace or the organization folder have no default status?
- Why can the default status not allow public use?
- Can I make new uploads public automatically?
- How do I make a status that allows public use the default for new uploads?
- Which changes does the rule about the default status refuse?
- Does changing the default status change files that already exist?
- Does a new version of a file get the default status again?
- Do files uploaded through the API or by an agent get the default status?
- What status does a file uploaded into a public folder get?
- What status do new uploads get after the default status is deleted?
- What happens when two admins pick different default statuses one after the other?
Deleting a status
- How do I delete a status?
- Who can delete a status?
- Can I delete a status that files still have?
- Are files deleted when their status is deleted?
- Do public links stop when a status is deleted?
- Can I delete the status that new uploads get?
- Can I undo deleting a status?
- What does "4 files will have no status." mean?
- What does "4 files will have no status, and so will 2 files in the trash." mean?
- What does "No file has this status." mean?
- What does "{name} deleted" with "1 public link stopped working." mean?
- What happens to files in the trash when their status is deleted?
- Does the API ask for a confirmation before deleting a status?
- What is
restrictedFileCountin the answer to deleting a status? - If I add a status with the same name again, do the files get it back?
- After deleting a status, how do I make its files public again?
- What does the API answer when a status that does not exist is deleted?
A file's status
- Where do I see the status of a file?
- Why does my file show no status badge in the list?
- Does a file keep its status when I rename or move it?
- Does a file keep its status when I replace it with a new version?
- Does a restored file have the status it had before it was trashed?
- Can I search for files by typing a status name?
- How does the API show a file's status?
- Can I change the status of a file that is in the trash?
Who can set a status
- Who can set or clear the status of a file?
- Why can I not set a status on a file I uploaded myself?
- Can the admin of a workspace set statuses on its files?
- Can a workspace admin set the status of an organization folder file?
- Who sets statuses on files in the organization folder?
- Does a person need a verified email to set a status in the browser?
- What does an agent need to approve files for public use?
- Why is there no "Set status" in my file menu?
- Why does a file's page show the status as a badge and not as a picker?
- My role changed while the page was open. What happens when I set a status?
Setting a status on one file
- How do I set the status of one file?
- How do I set a status from the file list without opening the file?
- How do I remove the status from a file?
- Which statuses does the picker "Status" offer?
- What does "Status set to {name}" mean?
- Can I set a status from the command palette?
- Does setting a status move a file or change its
lockVersion? - What does
changedFileIDshold when a file already had the status?
Setting a status on many files
- How do I set a status on many files at once?
- How do I set a status on every file in a folder?
- Does a status set on a folder apply to files added to it later?
- Does "Set status" on a folder reach files in its subfolders?
- What does
Set "Not approved" on 14 files in Press?ask me? - What does "{folder} holds no files." mean?
- What does "Could not count the files. Try again." mean in the status dialog of a folder?
- Can I set a status on more than 100 selected files in the app?
- What happens to folders in my selection when I choose "Set status"?
- What does "Set {n} files to {name}" mean?
- How do I set a status on files beyond the rows that are loaded?
- Why does setting a status say "A selected file is in the trash. Clear the selection and try again."?
- Why does setting a status say "A selected file no longer exists. The list is up to date now."?
- Is a status change on several files all or nothing?
- How do I set a status on more than 100 files through the API?
- Can one request set a status on files of two workspaces?
- What happens when a status request names the same file twice?
- What happens when a status request leaves out
statusID? - What happens when one file of a status request is in the trash?
Previews and confirmations
- Can I see what a status change will do before I make it?
- What does
dryRun: truedo in a status request? - Does a status preview write anything?
- Does a status preview need the same rights as the change?
- What does
madePublicFileIDshold in a status answer? - Does a status preview need
confirmVisibilityChange? - What happens when a status request sends both
dryRunandconfirmVisibilityChange? - Can the real status change do something else than the preview said?
- Why does the app ask "Change who can open these files?" when I set a status?
- When does the app set a status without asking anything?
- What happens when I choose "Cancel" on the status confirmation?
- Does the app ask once for every batch of 100 files?
- What does "A file would now become public, which it would not when you chose. Try again." mean?
- Why does the app ask before stopping public links when the API does not?
Status changes and public links
- What happens to a public link when the file gets a status that does not allow public use?
- What happens to a public link when I clear the file's status?
- Does setting "Approved for public use" on a file make it public?
- Why did a file become public when I only changed its status?
- I set the status back to an allowing one. Why is the link still dead?
- Do links through a public folder return when the status allows public use again?
- Does a CDN keep serving a file after its status stops allowing public use?
- When does a status change give a file its public link for the first time?
- Does a file leave the public gallery when its status stops allowing public use?
- Can a status change make a file public that is not in a public folder?
- What do
becomePublic,stopPublicandpublicViaread for a refused status change?
Filtering by status
- How do I filter files by status?
- How do I find files without a status in the app?
- How do I find all files that are not approved yet?
- Does the Status filter look in subfolders?
- Can I bookmark a file list filtered by status?
- How do I turn the Status filter off?
- Can I combine the status filter with other filters?
- What values does
status=take in a file listing? - What does a listing answer when
status=names a deleted status?
Counts and the "Statuses" card
- What does the "Statuses" card show?
- Why are the numbers in the "Statuses" card higher than the files I see in the open folder?
- What does the name in the corner of the "Statuses" card mean?
- Does the "Statuses" card count the whole organization?
- Does the "Statuses" card of a workspace count organization folder files?
- Does a search or a filter change the "Statuses" card?
- Why are the numbers in the "Statuses" card dimmed for a moment?
- Why is a status missing from the "Statuses" card?
- What does "No files yet" mean in the "Statuses" card?
- Do I have to reload to see new counts in the "Statuses" card?
- How do I count the files with each status in one workspace or folder?
- Do the status counts of a folder include its subfolders?
- Do the status counts of one place depend on who asks?
- What does
fileCounton a status count? - What does
publicFileCounton a status count? - What does
noStatusFileCountin the status list count? - Do my status counts differ from an admin's?
- Are files in the trash counted for a status?
- Why is
trashedFileCounton a statusnull? - Do the status counts of an API key cover the whole organization?
- Which numbers do the confirmations for deleting a status show?
Agents and the API
- What is the difference between
workspace_files_status_setandlibrary_files_status_set? - Why does a key with only
files:approvefail to list the statuses? - What does the answer to a status change hold?
- What should an agent do when a status change is refused with
VISIBILITY_CHANGE? - How can an agent learn what a status change does without triggering
VISIBILITY_CHANGE? - In what order is a request to set a status checked?
- Why does a status change answer
422with "Unknown status"? - Why does a status change answer
404 NOT_FOUND? - Why does a status change answer "name 1 to 100 files"?
- Does a status change through an API key record who did it?
- What happens to an agent's status change after its member is made a plain member?
- Why should an agent read the status list before setting a status?
- What do the browser-only status operations take and return?
Approval workflows
- How do I make sure files are reviewed before they can be public?
- Can I add review steps such as "In review" or "Licensed"?
- How do I let someone approve files in one workspace only?
- How do I withdraw the approval of a file?
- How do I withdraw the approval of many files at once?
- Can an AI agent do the approving for a team?
- Can an agent propose a status for a person to confirm?
- Can I find out who approved a file?
- Does approving a file tell the person who uploaded it?
- Can I use a status for something other than approval, such as "Archived"?
- Is a file approved for one workspace approved everywhere?