# 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](../files/statuses.md) that owns
the rule.

## The basics

### What is a file status in Talewright?

A status is a label on a file that says what the file may be used for, such
as "Approved for public use" or "Internal use only". Each status also says
whether files with it may be public.

More: [Statuses, Summary](../files/statuses.md#summary)

### Why does a file's status matter for sharing?

A file can be opened by anyone with its link only while its status allows
public use. A file without a status is never public. Whoever sets statuses
therefore decides what can leave the organization.

More: [Statuses, Summary](../files/statuses.md#summary)

### Do the organization folder and the workspaces use the same statuses?

No. Every workspace has its own list of statuses, and so does the
organization folder. Changing a status of one workspace
changes nothing in another workspace or in the organization folder, also
when their statuses have the same names.

More: [Statuses, The status lists](../files/statuses.md#the-status-lists)

### Can a file carry a status of another workspace or of the organization folder?

No. A file only ever has a status of its own workspace or organization
folder. Naming a status of another one answers `422 VALIDATION_FAILED` on
`statusID`.

More: [Statuses, The status lists](../files/statuses.md#the-status-lists)

### Can a file have more than one status?

No. A file has one status or none. For more labels on a file, use tags and
custom fields.

More: [Statuses, A file's status](../files/statuses.md#a-files-status)

### Can a file have no status at all?

Yes. The app calls that "No status" and the API reads `status` as `null`. A
file without a status behaves like a file whose status does not allow public
use: it is never public.

More: [Statuses, Allows public use](../files/statuses.md#allows-public-use)

### Do folders have a status?

No. A status belongs to a file. "Set status" on a folder sets the status
once on every live file in the folder and below it. It is not a property of
the folder.

More: [Statuses, Setting a status in the app](../files/statuses.md#setting-a-status-in-the-app)

### Is the status one of the custom fields?

No. The field list presents status as its built-in first field, but it has
its own rules, its own permissions and its own operations. It cannot be set
through a file's `fields`.

More: [Statuses, Elsewhere](../files/statuses.md#elsewhere)

### Who can see a file's status?

Everyone who can read the file. Everyone who can read a workspace also reads
its whole status list, and every member of the organization reads the
organization folder's, whatever their role.

More: [Statuses, Who can do what](../files/statuses.md#who-can-do-what)

### Can someone outside the organization read its status list?

No. Someone who cannot read the workspace, or who is not a member of the
organization, gets `404 NOT_FOUND`, the same answer as for one that does not
exist.

More: [Statuses, The status lists](../files/statuses.md#the-status-lists)

### Can a status of one organization be used on files of another?

No. A status applies only in its own workspace or organization folder, so
never in another organization. Naming one on a file answers `422
VALIDATION_FAILED` on `statusID`.

More: [Statuses, The status lists](../files/statuses.md#the-status-lists)

### Where is the status list in the app?

Each workspace and the organization folder have their own, on their
settings page "Statuses":

- The organization folder's: **Settings > File spaces > Organization folder > Statuses**.
- A workspace's: **Settings > File spaces >
  {workspace} > Statuses**.

Everyone who can open the page sees the table "Statuses" there.

More: [Statuses, The status list in settings](../files/statuses.md#the-status-list-in-settings)

### What is the address of the status settings page?

- The organization folder:
  `https://app.usetalewright.com/settings/organization/{organizationID}/library/statuses`.
- A workspace:
  `https://app.usetalewright.com/settings/organization/{organizationID}/workspaces/{workspaceID}/files/statuses`.

The same address without `/statuses` opens this page too. The page holds
the section "Status".

More: [Statuses, The status list in settings](../files/statuses.md#the-status-list-in-settings)

### What does each row of the "Statuses" table in settings show?

Under "Name", the status's name and "New uploads" when it is the default;
under "Sharing", "Public use" or "No public use"; under "Files", the number
of files that have it, such as "12 files".

More: [Statuses, The status list in settings](../files/statuses.md#the-status-list-in-settings)

### Is anyone notified when a file's status changes?

No. No email is sent. The change is recorded in the audit trail.

More: [Statuses, Elsewhere](../files/statuses.md#elsewhere)

### Which audit events record changes to statuses?

`file_status.created`, `file_status.updated`, `file_status.deleted` and
`file_status.reordered` for the list, and `file.status_changed` once per file
when a status is set or cleared.

More: [Statuses, Elsewhere](../files/statuses.md#elsewhere)

### Can the status list of a workspace or the organization folder be empty?

Yes. When every status of a list is deleted, the list is empty. There is
then no status to set in that workspace or organization folder, none of its
files can be public, and its new uploads start without a status.

More: [Statuses, The status lists](../files/statuses.md#the-status-lists)

## The three starting statuses

### Which statuses does a new workspace or organization folder start with?

Three, in this order: "Approved for public use", "Internal use only" and
"Not approved". Every new workspace gets its own three, and so does the
organization folder of every new organization.

More: [Statuses, The three starting statuses](../files/statuses.md#the-three-starting-statuses)

### What does the status "Approved for public use" do?

It allows public use. A file with it can be shared with "Anyone with the
link". It does not make the file public by itself, and it is not the status
new uploads get.

More: [Statuses, The three starting statuses](../files/statuses.md#the-three-starting-statuses)

### What does the status "Internal use only" do?

It does not allow public use, and in a new workspace or organization folder
it is the default: new uploads get it. A file with it cannot be made public.

More: [Statuses, The three starting statuses](../files/statuses.md#the-three-starting-statuses)

### What does the status "Not approved" do?

It does not allow public use and is not the default for new uploads. A file
with it cannot be made public.

More: [Statuses, The three starting statuses](../files/statuses.md#the-three-starting-statuses)

### Which of the starting statuses allows public use?

Only "Approved for public use". "Internal use only" and "Not approved" do
not.

More: [Statuses, The three starting statuses](../files/statuses.md#the-three-starting-statuses)

### Can I rename the three starting statuses?

Yes. They are ordinary statuses. Owners and admins of the workspace or
organization folder rename, reorder and delete them like any other, in that
workspace or organization folder only.

More: [Statuses, The three starting statuses](../files/statuses.md#the-three-starting-statuses)

### Can I delete "Approved for public use", "Internal use only" or "Not approved"?

Yes. Any status can be deleted, also one of the three starting statuses and
also the default. Files that had it are left without a status.

More: [Statuses, Deleting a status](../files/statuses.md#deleting-a-status)

### Does the name of a status decide what it does?

No. Nothing ties behavior to a name. What counts is whether the status
allows public use and whether it is the default for new uploads. A status
renamed to "Approved" does not start allowing public use.

More: [Statuses, The three starting statuses](../files/statuses.md#the-three-starting-statuses)

## Adding a status

### How do I add a status?

1. Open the settings page of the workspace's statuses (**Settings >
   File spaces > {workspace} > Statuses**) or of the
   organization folder's (**Settings > File spaces >
   Organization folder > Statuses**).
2. Choose "Add status".
3. Fill in "Name" and tick "Allows public use" if files with it may be
   shared publicly.
4. Choose "Add status".

The dialog closes and the new status is last in the list.

More: [Statuses, Adding a status in the app](../files/statuses.md#adding-a-status-in-the-app)

### Who can add a status?

For a workspace, its owners and admins and the organization's owners and
admins. For the organization folder, the organization's owners and admins.
Always signed in with a browser.

More: [Statuses, Adding a status](../files/statuses.md#adding-a-status)

### Can a member add, rename or delete a status?

Not as a plain member. A plain member who tries gets `403 FORBIDDEN` and
nothing changes. A member reads the list and sees every file's status.

More: [Statuses, Who can do what](../files/statuses.md#who-can-do-what)

### Can a workspace admin who is a plain member of the organization manage the status list?

That workspace's, yes: its owners and admins manage its statuses and set
them on its files. The organization folder's, no: that needs the
organization role owner or admin, and the answer is `403 FORBIDDEN`.

More: [Statuses, Who can do what](../files/statuses.md#who-can-do-what)

### Why is there no "Add status" button on my settings page?

"Add status" and the menu "Manage {name}" are shown only to the owners and
admins of that workspace or organization folder. Everyone else sees the list
without them.

More: [Statuses, The status list in settings](../files/statuses.md#the-status-list-in-settings)

### What does a new status need?

A name and whether it allows public use. Nothing else.

More: [Statuses, Adding a status](../files/statuses.md#adding-a-status)

### Where does a new status go in the list?

It is placed last. Use "Move up" in its "Manage" menu to move it.

More: [Statuses, Adding a status](../files/statuses.md#adding-a-status)

### Is a new status the default for new uploads?

No. A new status is never the default when it is created. Make it the
default afterwards with "Use for new uploads".

More: [Statuses, The default status](../files/statuses.md#the-default-status)

### What does the checkbox "Allows public use" in the "Add status" dialog mean?

Ticked, files with the new status can be shared publicly. The dialog says
"Files with it can be shared publicly." Unticked, files with it cannot be
public.

More: [Statuses, Adding a status in the app](../files/statuses.md#adding-a-status-in-the-app)

### Why does the "Add status" dialog say "Enter a name of 1 to 60 characters."?

The name is blank or longer than 60 characters. Spaces at the start and end
do not count.

More: [Statuses, Adding a status in the app](../files/statuses.md#adding-a-status-in-the-app)

### Why does the "Add status" dialog say "Another status has that name."?

Another status of the same workspace or organization folder already has that
name, ignoring case. Choose another name.

More: [Statuses, Adding a status in the app](../files/statuses.md#adding-a-status-in-the-app)

### How do I make room for a new status when the list is full?

Delete a status first. A workspace or the organization folder has at most 50
statuses, whatever their names. The dialog says "A workspace or the
organization folder can have up to 50 statuses. Delete one to add another."

More: [Statuses, Adding a status](../files/statuses.md#adding-a-status)

### Why does adding a status with an API key answer `SESSION_REQUIRED`?

A status list is managed only by a person in a browser. A credential that
adds, changes, reorders or deletes a status gets `403 FORBIDDEN` with
`details.reason` `SESSION_REQUIRED`, whatever its scopes.

More: [Statuses, Who can do what](../files/statuses.md#who-can-do-what)

### What does the API answer when a status is added?

`201` with the new status: its `id`, `name`, `allowsPublic`, `isDefault`,
`position` and counts.

More: [Statuses, Adding a status](../files/statuses.md#adding-a-status)

### In what order is a request to add a status checked?

1. Not signed in: `401 UNAUTHENTICATED`.
2. Unknown or deleted workspace or organization, or one you cannot read:
   `404 NOT_FOUND`.
3. The body is not the expected JSON: `422 VALIDATION_FAILED`.
4. Not an owner or admin of the workspace or organization folder: `403
   FORBIDDEN`.
5. The name breaks the naming rules: `422` on `name`.
6. The workspace or organization folder already has 50 statuses: `422` on
   `statuses`.
7. Another status has the name: `409 CONFLICT`, reason `NAME_TAKEN`.

The first check that fails decides the answer.

More: [Statuses, Adding a status](../files/statuses.md#adding-a-status)

## Status names

### Can a status name contain a tab or a line break?

No. A name with a control character, such as a tab or a line break, is
refused, also at the very end of the name.

More: [Statuses, Names](../files/statuses.md#names)

### Are spaces at the start or end of a status name kept?

No. They are removed before the name is measured and stored.

More: [Statuses, Names](../files/statuses.md#names)

### Can a status have an empty name?

No. A name that is empty after trimming is refused with
`422 VALIDATION_FAILED` on `name`.

More: [Statuses, Names](../files/statuses.md#names)

### Can "Licensed" and "licensed" both exist as statuses?

Not in one list. A status name is unique in its workspace or organization
folder, ignoring case. The second one answers `409 CONFLICT` with reason
`NAME_TAKEN`.

More: [Statuses, Names](../files/statuses.md#names)

### Can two workspaces, or two organizations, use the same status names?

Yes. Names only have to be unique within one workspace or organization folder. A
workspace and the organization folder can each have a status of the same name.

More: [Statuses, Names](../files/statuses.md#names)

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

Yes. The name of a deleted status is free at once.

More: [Statuses, Names](../files/statuses.md#names)

### Why was my status name refused with `422 VALIDATION_FAILED` on `name`?

The name is blank after trimming, longer than 60 characters or holds a
control character such as a line break.

More: [Statuses, Names](../files/statuses.md#names)

### What does `NAME_TAKEN` mean when I add or rename a status?

Another status of the same workspace or organization folder has that name,
ignoring case. The answer is `409 CONFLICT` with the message "Another status
has that name". Choose another name.

More: [Statuses, Errors](../files/statuses.md#errors)

## Renaming a status

### How do I rename a status?

Open "Manage {name}" on the status's row and choose "Rename". The dialog
"Rename {name}" has the field "Name" and the button "Rename".

More: [Statuses, The "Manage" menu](../files/statuses.md#the-manage-menu)

### Who can rename a status?

Owners and admins of the workspace or organization folder the status belongs
to, in a browser. For a workspace that includes the organization's owners
and admins.

More: [Statuses, Renaming a status](../files/statuses.md#renaming-a-status)

### Does renaming a status change the files that have it?

Only the label they show. The rename changes the label at once on every
file that has the status. The files keep the status. A status with the same
name in another workspace or the organization folder keeps its name.

More: [Statuses, Renaming a status](../files/statuses.md#renaming-a-status)

### Does renaming a status start or stop any public link?

No. A rename keeps whether the status allows public use, so no public link
starts or stops.

More: [Statuses, Renaming a status](../files/statuses.md#renaming-a-status)

### Does a renamed status keep its ID and its place in the list?

Yes. A rename changes only the name. The status keeps its ID, its files, its
position, whether it allows public use and whether it is the default.

More: [Statuses, Renaming a status](../files/statuses.md#renaming-a-status)

### Can I change only the capital letters of a status name?

Yes. A rename that only changes the case of the name is allowed, because it
conflicts with no other status.

More: [Statuses, Renaming a status](../files/statuses.md#renaming-a-status)

### Can one request rename a status and change its other settings?

Yes. One request can change any of the name, `allowsPublic` and `isDefault`.
Properties left out stay as they are.

More: [Statuses, Changing a status](../files/statuses.md#changing-a-status)

### What happens when one part of a combined status change is refused?

Nothing changes. A refused request changes nothing, also when only one of
several changes in it was the problem. A rename sent together with a refused
"allows public use" change is not applied either.

More: [Statuses, Changing a status](../files/statuses.md#changing-a-status)

## The order of the statuses

### How do I change the order of the statuses?

Open "Manage {name}" on a status's row and choose "Move up" or "Move down".
Each moves the status one place.

More: [Statuses, The "Manage" menu](../files/statuses.md#the-manage-menu)

### Who can reorder the statuses?

Owners and admins of the workspace or organization folder, in a browser. For a
workspace that includes the organization's owners and admins.

More: [Statuses, Reordering](../files/statuses.md#reordering)

### Where does the order of the statuses show?

Everywhere the list is shown: in settings, in the status pickers and in the
Status filter.

More: [Statuses, Reordering](../files/statuses.md#reordering)

### Does reordering statuses change any file or public link?

No. Reordering changes no file and no public link.

More: [Statuses, Reordering](../files/statuses.md#reordering)

### Why is there no "Move up" on the first status?

The first status cannot move further up, and the last has no "Move down".

More: [Statuses, The "Manage" menu](../files/statuses.md#the-manage-menu)

### How does a reorder request name the new order of statuses?

It names every status of that workspace or organization folder exactly once,
in the new order, in `statusIDs`. The answer is the whole list in its new
order.

More: [Statuses, Reordering](../files/statuses.md#reordering)

### Why did my reorder fail after a colleague added a status?

Your page was loaded before the new status existed, so your request did not
name it. A reorder that leaves a status out is refused with `422`. Reload
and reorder again.

More: [Statuses, Edge cases](../files/statuses.md#edge-cases)

### How are the positions of statuses numbered?

From 0, without a hole. When a status in the middle is deleted, the statuses
after it move up one position.

More: [Statuses, The status lists](../files/statuses.md#the-status-lists)

## Allows public use

### What does "allows public use" mean on a status?

It means files with that status may be public. A file is public only while
its status allows public use. A status that does not allow it blocks
sharing: making such a file public is refused, and a link the file had
stops.

More: [Statuses, Allows public use](../files/statuses.md#allows-public-use)

### Does a status that allows public use make its files public?

No. It only makes sharing possible. The file, or a folder above it, must
also be shared with "Anyone with the link".

More: [Statuses, Allows public use](../files/statuses.md#allows-public-use)

### What do "Public use" and "No public use" mean beside a status?

"Public use" marks a status that allows public use. "No public use" marks
one that does not. The app shows one of the two beside each status.

More: [Statuses, Allows public use](../files/statuses.md#allows-public-use)

### How do I let an existing status allow public use?

Open "Manage {name}" on its row and choose "Allow public use". It takes
effect at once when it makes no file public. Otherwise the app asks first.

More: [Statuses, The "Manage" menu](../files/statuses.md#the-manage-menu)

### How do I stop a status from allowing public use?

Open "Manage {name}" and choose "Stop allowing public use". The app asks
"Stop public use of {name}?" and says how many public links will stop.
Confirm with "Stop public use".

More: [Statuses, The "Manage" menu](../files/statuses.md#the-manage-menu)

### Who can change whether a status allows public use?

Owners and admins of the workspace or organization folder, in a browser. For a
workspace that includes the organization's owners and admins. No credential
can.

More: [Statuses, Who can do what](../files/statuses.md#who-can-do-what)

### What happens to public files when their status stops allowing public use?

Every public file with that status becomes restricted at once, in one step.
Their links answer `404` like links that never existed. Files of other
workspaces or the organization folder are not touched, also when their
status has the same name.

More: [Statuses, Status changes that change access](../files/statuses.md#status-changes-that-change-access)

### What does "3 public links will stop working. Allowing public use again brings back only the links of files in public folders." mean?

Three files with the status are public now and will stop being public. The
count holds both kinds of links. Those of files shared on their own stay
stopped until each file is shared again. Those of files in public folders
return when public use is allowed again and confirmed.

More: [Statuses, The "Manage" menu](../files/statuses.md#the-manage-menu)

### What does "No file with it is public. Its files can no longer be shared publicly." mean?

No public link will stop, because no file with the status is public now.
After the change, files with the status cannot be made public.

More: [Statuses, The "Manage" menu](../files/statuses.md#the-manage-menu)

### If I allow public use on a status again, do the stopped links come back?

Partly. Files that were public themselves stay restricted until an owner or
admin shares each one again. Files in public folders become public again,
after you confirm.

More: [Statuses, Status changes that change access](../files/statuses.md#status-changes-that-change-access)

### Why does "Allow public use" on a status ask "Change who can open these files?" first?

Files with the status sit in public folders, so they would become public the
moment the status allows it. The app says how many, for example "2 files
will become public.", and waits for "Allow public use" or "Cancel".

More: [Statuses, The "Manage" menu](../files/statuses.md#the-manage-menu)

### Does the API ask before a status starts allowing public use?

Only when that would make files public. Then the request is refused with
`409 CONFLICT`, reason `VISIBILITY_CHANGE`, with the count in
`details.becomePublic`, and changes nothing. Repeating it with
`confirmVisibilityChange: true` carries it out.

More: [Statuses, Status changes that change access](../files/statuses.md#status-changes-that-change-access)

### Does the API ask before a status stops allowing public use?

No. Stopping links needs no confirmation in the API. The app asks first all
the same.

More: [Statuses, Status changes that change access](../files/statuses.md#status-changes-that-change-access)

### Can more than one status allow public use?

Yes. Each status either allows public use or does not, and each is set on
its own. Only the default status can never allow it.

More: [Statuses, Allows public use](../files/statuses.md#allows-public-use)

## The status for new uploads

### What is the default status?

The status new uploads get. At most one status of each workspace or
organization folder is the default. In settings it carries the mark "New
uploads".

More: [Statuses, The default status](../files/statuses.md#the-default-status)

### Which status does a newly uploaded file get?

The default status of the workspace or organization folder it is uploaded
to. In a new workspace or organization folder that is "Internal use only".
When no status is the default, a new upload starts without a status.

More: [Statuses, The default status](../files/statuses.md#the-default-status)

### What does "New uploads" mean beside a status in settings?

That status is the default. Every new file made by an upload starts with it.

More: [Statuses, The status list in settings](../files/statuses.md#the-status-list-in-settings)

### How do I change which status new uploads get?

Open "Manage {name}" on the status you want and choose "Use for new
uploads". The mark "New uploads" moves to it.

More: [Statuses, The "Manage" menu](../files/statuses.md#the-manage-menu)

### What does "Stop using for new uploads" do?

It switches the default off without choosing another. Afterwards no status
is marked, and new uploads start without a status.

More: [Statuses, The "Manage" menu](../files/statuses.md#the-manage-menu)

### What happens to the old default when I make another status the default?

It loses the mark. Making a status the default takes the mark away from the
status that had it. There are never two defaults.

More: [Statuses, The default status](../files/statuses.md#the-default-status)

### Can a workspace or the organization folder have no default status?

Yes. A default is optional. Without one, new uploads start without a status
and cannot be public until someone gives them an allowing status.

More: [Statuses, The default status](../files/statuses.md#the-default-status)

### Why can the default status not allow public use?

So that no upload is public at once. Otherwise a file dropped into a public
folder would be public before anyone who may set statuses had looked at it.

More: [Statuses, The default status](../files/statuses.md#the-default-status)

### Can I make new uploads public automatically?

No. The default status never allows public use. Someone who may set statuses
has to give each file a status that allows public use.

More: [Statuses, The default status](../files/statuses.md#the-default-status)

### How do I make a status that allows public use the default for new uploads?

First stop it allowing public use, then make it the default. In the app,
choose "Stop allowing public use" and then "Use for new uploads". In the API
one request with `allowsPublic: false` and `isDefault: true` is accepted.

More: [Statuses, The default status](../files/statuses.md#the-default-status)

### Which changes does the rule about the default status refuse?

Three: making a status the default while it allows public use, allowing
public use on the status that is the default, and doing both in one request.
Each answers `409 CONFLICT`, reason `DEFAULT_ALLOWS_PUBLIC`, with the
message "The status new uploads get cannot allow public use".

More: [Statuses, The default status](../files/statuses.md#the-default-status)

### Does changing the default status change files that already exist?

No. The default applies when a file is created. Files that exist keep their
status. Only uploads from then on get the new default.

More: [Statuses, The default status](../files/statuses.md#the-default-status)

### Does a new version of a file get the default status again?

No. A replacement upload keeps the file's status. The default is not applied
again.

More: [Statuses, The default status](../files/statuses.md#the-default-status)

### Do files uploaded through the API or by an agent get the default status?

Yes. A new file starts with the default status in workspaces and in the
organization folder, in the app and through a credential.

More: [Statuses, The default status](../files/statuses.md#the-default-status)

### What status does a file uploaded into a public folder get?

The default status, like any upload. Because the default never allows public
use, the file is not public and is not listed in the folder's public
gallery until someone who may set statuses approves it.

More: [Statuses, The default status](../files/statuses.md#the-default-status)

### What status do new uploads get after the default status is deleted?

None. Deleting the default does not pick a new one. New uploads start
without a status until another status is made the default.

More: [Statuses, Deleting a status](../files/statuses.md#deleting-a-status)

### What happens when two admins pick different default statuses one after the other?

Both changes succeed, and the later one is the default. Each change takes
the mark away from the status that had it.

More: [Statuses, The default status](../files/statuses.md#the-default-status)

## Deleting a status

### How do I delete a status?

Open "Manage {name}" on its row and choose "Delete". The app asks "Delete
{name}?" and says how many files will have no status and how many public
links will stop. Confirm with "Delete status".

More: [Statuses, The "Manage" menu](../files/statuses.md#the-manage-menu)

### Who can delete a status?

Owners and admins of the workspace or organization folder, in a browser. For a
workspace that includes the organization's owners and admins.

More: [Statuses, Deleting a status](../files/statuses.md#deleting-a-status)

### Can I delete a status that files still have?

Yes. Every file that had the status is left without a status. The app tells
you how many before you confirm.

More: [Statuses, Deleting a status](../files/statuses.md#deleting-a-status)

### Are files deleted when their status is deleted?

No. The files themselves stay. Nothing is trashed or deleted. They only lose
the status.

More: [Statuses, Deleting a status](../files/statuses.md#deleting-a-status)

### Do public links stop when a status is deleted?

Yes. Every file that had the status becomes restricted. A file that was
public, itself or through a public folder, stops being public at once.

More: [Statuses, Deleting a status](../files/statuses.md#deleting-a-status)

### Can I delete the status that new uploads get?

Yes. There is no default afterwards, and new uploads start without a status
until another status is made the default.

More: [Statuses, Deleting a status](../files/statuses.md#deleting-a-status)

### Can I undo deleting a status?

No. You can add a status with the same name, but it is a new status with a
new ID. Set it on the files again and share again what should be public.

More: [Statuses, Deleting a status](../files/statuses.md#deleting-a-status)

### What does "4 files will have no status." mean?

Four live files have the status you are about to delete. After the deletion
they have no status. When some of them are public, the app adds, for
example, "1 public link will stop working."

More: [Statuses, The "Manage" menu](../files/statuses.md#the-manage-menu)

### What does "4 files will have no status, and so will 2 files in the trash." mean?

Besides four live files, two files in the trash of the same workspace or
organization folder have the status. All six lose it. The two come back
without a status if they are restored.

More: [Statuses, The "Manage" menu](../files/statuses.md#the-manage-menu)

### What does "No file has this status." mean?

Deleting the status changes no file. No live file has it.

More: [Statuses, The "Manage" menu](../files/statuses.md#the-manage-menu)

### What does "{name} deleted" with "1 public link stopped working." mean?

The status was deleted, and one file that had it was public. Its link
stopped with the deletion.

More: [Statuses, The "Manage" menu](../files/statuses.md#the-manage-menu)

### What happens to files in the trash when their status is deleted?

They lose the status too. Restored, they come back without a status and
restricted.

More: [Statuses, Deleting a status](../files/statuses.md#deleting-a-status)

### Does the API ask for a confirmation before deleting a status?

No. Deleting a status can only stop public links. It can never make a file
public, so the API deletes at once. The app asks first.

More: [Statuses, Deleting a status](../files/statuses.md#deleting-a-status)

### What is `restrictedFileCount` in the answer to deleting a status?

The number of files whose public link stopped. Files in the trash are not
counted, because a trashed file was not public.

More: [Statuses, Deleting a status](../files/statuses.md#deleting-a-status)

### If I add a status with the same name again, do the files get it back?

No. The new status has a new ID, and no file has it. Set it on the files
again.

More: [Statuses, Deleting a status](../files/statuses.md#deleting-a-status)

### After deleting a status, how do I make its files public again?

Give them a status that allows public use. Files in a public folder become
public through that folder again, after a confirmation. A file that was
public itself has to be shared again.

More: [Statuses, Deleting a status](../files/statuses.md#deleting-a-status)

### What does the API answer when a status that does not exist is deleted?

`404 NOT_FOUND`, the same as for a status of another workspace, of the
organization folder or of another organization.

More: [Statuses, Deleting a status](../files/statuses.md#deleting-a-status)

## A file's status

### Where do I see the status of a file?

In the list view, in the column "Status". When the list is too narrow for
the column, the status is under the file's name. In the grid view it is
under the file's name on each tile, after a colored dot and before the
size. On a file's page it is in the section "Status", the first section in
the right column of "Details", under the preview. On a narrow screen it
follows the section "Details".

More: [Statuses, A file's status in the app](../files/statuses.md#a-files-status-in-the-app)

### Why does my file show no status badge in the list?

It has no status. A file without a status shows no status badge in the
listing. On its page it reads "No status".

More: [Statuses, A file's status in the app](../files/statuses.md#a-files-status-in-the-app)

### Does a file keep its status when I rename or move it?

Yes. Renaming, moving, tagging, describing, trashing and restoring a file do
not change its status.

More: [Statuses, A file's status](../files/statuses.md#a-files-status)

### Does a file keep its status when I replace it with a new version?

Yes. The status belongs to the file, not to a version. A new version keeps
it and, if the file is public, its link.

More: [Statuses, A file's status](../files/statuses.md#a-files-status)

### Does a restored file have the status it had before it was trashed?

Yes, unless the status was deleted meanwhile. Trashing and restoring do not
change a status. A file whose status was deleted comes back without one.

More: [Statuses, A file's status](../files/statuses.md#a-files-status)

### Can I search for files by typing a status name?

No. Search does not look at status names. To find files by status, use
"Filter" > "Status".

More: [Statuses, A file's status](../files/statuses.md#a-files-status)

### How does the API show a file's status?

As `status`: `{id, name, allowsPublic}`, or `null` for "No status". File
listings carry it too.

More: [Statuses, A file's status](../files/statuses.md#a-files-status)

### Can I change the status of a file that is in the trash?

No. A file in the trash shows its status read-only to everyone. Through the
API the request answers `409 CONFLICT`, reason `IN_TRASH`. Restore the file
first.

More: [Statuses, Setting a status on files](../files/statuses.md#setting-a-status-on-files)

## Who can set a status

### Who can set or clear the status of a file?

Owners and admins. For a workspace file the effective workspace role
counts: organization owners and admins, and members who are owner or admin
of that workspace. For an organization folder file the organization role counts.

More: [Statuses, Who can do what](../files/statuses.md#who-can-do-what)

### Why can I not set a status on a file I uploaded myself?

Setting a status decides what may become public. That is kept with owners
and admins, whoever uploaded the file. A plain member cannot set a status,
not even on their own upload.

More: [Statuses, Who can do what](../files/statuses.md#who-can-do-what)

### Can the admin of a workspace set statuses on its files?

Yes. A plain member of the organization who is admin or owner of one
workspace sets statuses on that workspace's files.

More: [Statuses, Who can do what](../files/statuses.md#who-can-do-what)

### Can a workspace admin set the status of an organization folder file?

Not through the workspace role. Organization folder files need the
organization role owner or admin. A member with only a workspace role gets
`403 FORBIDDEN`.

More: [Statuses, Edge cases](../files/statuses.md#edge-cases)

### Who sets statuses on files in the organization folder?

Owners and admins of the organization, in a browser or through a credential
with `files:approve`.

More: [Statuses, Who can do what](../files/statuses.md#who-can-do-what)

### Does a person need a verified email to set a status in the browser?

No. A person in a browser session needs no verified email to set a status.
Only a status change through a credential needs its member's email to be
verified.

More: [Statuses, Who can do what](../files/statuses.md#who-can-do-what)

### What does an agent need to approve files for public use?

Three things: a credential with the scope `files:approve`, a member behind
it who is an owner or admin at that moment, and a verified email address of
that member. To look up statuses and files first it also needs `files:read`.

More: [Statuses, For agents](../files/statuses.md#for-agents)

### Why is there no "Set status" in my file menu?

"Set status" is offered only to owners and admins. As a member you see each
file's status and cannot change it.

More: [Statuses, Setting a status in the app](../files/statuses.md#setting-a-status-in-the-app)

### Why does a file's page show the status as a badge and not as a picker?

You are not an owner or admin there. Owners and admins get the picker
"Status". Everyone else reads the status as a badge, or the badge "No
status", with "Owners and admins set the status."

More: [Statuses, A file's status in the app](../files/statuses.md#a-files-status-in-the-app)

### My role changed while the page was open. What happens when I set a status?

The change is refused and the app says "Only owners and admins set
statuses." The role is checked at each change, not when the page loads.

More: [Statuses, Setting a status in the app](../files/statuses.md#setting-a-status-in-the-app)

## Setting a status on one file

### How do I set the status of one file?

On the file's page, choose from the picker in the section "Status".
Choosing a status saves it, after a confirmation when it changes who can
open the file.

More: [Statuses, Setting a status in the app](../files/statuses.md#setting-a-status-in-the-app)

### How do I set a status from the file list without opening the file?

Open the file's row menu, "File actions for {name}" or a right-click, and
choose "Set status". The dialog "Status of {name}" shows the picker "Status"
at the file's current status. Choosing a status saves it and closes the
dialog.

More: [Statuses, Setting a status in the app](../files/statuses.md#setting-a-status-in-the-app)

### How do I remove the status from a file?

Choose "No status" in the picker "Status". Through the API, send `statusID`
`null`. If the file was public, its link stops.

More: [Statuses, Setting a status on files](../files/statuses.md#setting-a-status-on-files)

### Which statuses does the picker "Status" offer?

"No status" and then every status of the file's workspace or organization
folder, in the order of its list.

More: [Statuses, A file's status in the app](../files/statuses.md#a-files-status-in-the-app)

### What does "Status set to {name}" mean?

The status was set on one file. When a public link stopped with it, the
message adds, for example, "1 public link stopped working."

More: [Statuses, Setting a status in the app](../files/statuses.md#setting-a-status-in-the-app)

### Can I set a status from the command palette?

Yes. The command palette offers "Set status" under "Files & Assets" when it
has exactly one file or folder to act on.

More: [Statuses, Setting a status in the app](../files/statuses.md#setting-a-status-in-the-app)

### Does setting a status move a file or change its `lockVersion`?

No. Setting a status does not move the file, does not change its
`lockVersion` and does not need the `lockVersion` in the request.

More: [Statuses, Setting a status on files](../files/statuses.md#setting-a-status-on-files)

### What does `changedFileIDs` hold when a file already had the status?

Nothing for that file. Setting the status a file already has succeeds and
changes nothing else. `changedFileIDs` names only the files that had
another status, or none.

More: [Statuses, Setting a status on files](../files/statuses.md#setting-a-status-on-files)

## Setting a status on many files

### How do I set a status on many files at once?

1. Select the files in a listing. Shift-click selects a range.
2. In the toolbar "Selected files", choose "Set status".
3. Choose "No status" or one of the statuses.

The status is set on every selected file, after one confirmation when it
changes who can open some of them.

More: [Statuses, Setting a status in the app](../files/statuses.md#setting-a-status-in-the-app)

### How do I set a status on every file in a folder?

Choose "Set status" in the folder's row menu, or at the bottom of the card
"Statuses" in the folder's "Details". Pick a status in the dialog "Status of {folder}",
read what it will do, and choose "Set status".

More: [Statuses, Setting a status in the app](../files/statuses.md#setting-a-status-in-the-app)

### Does a status set on a folder apply to files added to it later?

No. The status is set once, on the files that are there. A file moved in
later keeps its own status, and a new upload starts with the default status.

More: [Statuses, Setting a status in the app](../files/statuses.md#setting-a-status-in-the-app)

### Does "Set status" on a folder reach files in its subfolders?

Yes. It sets the status on every live file in the folder and in every folder
below it.

More: [Statuses, Setting a status in the app](../files/statuses.md#setting-a-status-in-the-app)

### What does `Set "Not approved" on 14 files in Press?` ask me?

Whether to set that status on all 14 live files in the folder "Press" and
below it. The dialog adds what the change does to access, such as "2 public
links will stop working." or "3 files will become public." "Set status"
applies it. No second question follows.

More: [Statuses, Setting a status in the app](../files/statuses.md#setting-a-status-in-the-app)

### What does "{folder} holds no files." mean?

The folder and the folders below it hold no live file, so there is nothing
to set a status on. "Set status" stays disabled.

More: [Statuses, Setting a status in the app](../files/statuses.md#setting-a-status-in-the-app)

### What does "Could not count the files. Try again." mean in the status dialog of a folder?

The app could not read how many files the folder holds, so it cannot say
what the change would do. Nothing was changed. Try again.

More: [Statuses, Setting a status in the app](../files/statuses.md#setting-a-status-in-the-app)

### Can I set a status on more than 100 selected files in the app?

Yes. A selection of more than 100 files is sent in batches of 100. One
message reports the whole selection, and the question about access is asked
once with the totals.

More: [Statuses, Setting a status in the app](../files/statuses.md#setting-a-status-in-the-app)

### What happens to folders in my selection when I choose "Set status"?

They are left alone. "Set status" is offered when at least one file is
selected, and it changes only the selected files.

More: [Statuses, Setting a status in the app](../files/statuses.md#setting-a-status-in-the-app)

### What does "Set {n} files to {name}" mean?

The status was set on that many files. When public links stopped, the
message adds, for example, "2 public links stopped working."

More: [Statuses, Setting a status in the app](../files/statuses.md#setting-a-status-in-the-app)

### How do I set a status on files beyond the rows that are loaded?

Select every loaded row, then choose "Select everything here". It selects
the rest too, up to 1,000 more files each time; when the app says more
remain, choose it again. Then choose "Set status".

More: [Statuses, Setting a status in the app](../files/statuses.md#setting-a-status-in-the-app)

### Why does setting a status say "A selected file is in the trash. Clear the selection and try again."?

One of the selected files went to the trash after you selected it. A status
can be set only on live files. Clear the selection and select again.

More: [Statuses, Setting a status in the app](../files/statuses.md#setting-a-status-in-the-app)

### Why does setting a status say "A selected file no longer exists. The list is up to date now."?

One of the files was deleted for good or moved out of your reach since the
list loaded. The list was refreshed. Select again and repeat.

More: [Statuses, Setting a status in the app](../files/statuses.md#setting-a-status-in-the-app)

### Is a status change on several files all or nothing?

Per request, yes. One request sets one status on 1 to 100 files, and all of
them change together or none does. Several requests are independent of each
other.

More: [Statuses, Setting a status on files](../files/statuses.md#setting-a-status-on-files)

### How do I set a status on more than 100 files through the API?

Send several requests of up to 100 files. To know the effect of all of them
before any is made, send each with `dryRun: true` first, add up the lists,
show the totals to a person and only then send the changes.

More: [Statuses, Previewing a status change](../files/statuses.md#previewing-a-status-change)

### Can one request set a status on files of two workspaces?

No. The files must all belong to the workspace or organization folder in the
path. If one is in another workspace, the whole request answers `404
NOT_FOUND` and no file changes.

More: [Statuses, Setting a status on files](../files/statuses.md#setting-a-status-on-files)

### What happens when a status request names the same file twice?

The file counts once. The answer's `fileIDs` names each file once.

More: [Statuses, Setting a status on files](../files/statuses.md#setting-a-status-on-files)

### What happens when a status request leaves out `statusID`?

It is refused with `422 VALIDATION_FAILED` and clears nothing. Only an
explicit `null` clears the status.

More: [Statuses, Setting a status on files](../files/statuses.md#setting-a-status-on-files)

### What happens when one file of a status request is in the trash?

The whole request is refused with `409 CONFLICT`, reason `IN_TRASH`, and no
file changes. Restore the file or leave it out.

More: [Statuses, Setting a status on files](../files/statuses.md#setting-a-status-on-files)

## Previews and confirmations

### Can I see what a status change will do before I make it?

Yes. The app reads the whole effect before it sets anything and asks when
files would become public or public links would stop. Through the API or
MCP, send the request with `dryRun: true`.

More: [Statuses, Previewing a status change](../files/statuses.md#previewing-a-status-change)

### What does `dryRun: true` do in a status request?

It changes nothing and answers what the request would do right now: the same
`200` answer with `dryRun: true`, naming the files whose status would
change, that would become public and whose public link would stop.

More: [Statuses, Previewing a status change](../files/statuses.md#previewing-a-status-change)

### Does a status preview write anything?

No. Nothing is set: no status, no public link, no `lockVersion` and no entry
in the audit trail.

More: [Statuses, Previewing a status change](../files/statuses.md#previewing-a-status-change)

### Does a status preview need the same rights as the change?

Yes. Everything is checked as for the change itself and refused the same
way: the role, the scope `files:approve`, the verified email, `statusID`,
`fileIDs` and files in the trash.

More: [Statuses, Previewing a status change](../files/statuses.md#previewing-a-status-change)

### What does `madePublicFileIDs` hold in a status answer?

The files in a public folder that became public because the status allows
public use. In a preview, the files that would become public.

More: [Statuses, Setting a status on files](../files/statuses.md#setting-a-status-on-files)

### Does a status preview need `confirmVisibilityChange`?

No. A preview never answers `VISIBILITY_CHANGE`, because it changes nothing.
It is how to learn what a confirmation would allow.

More: [Statuses, Previewing a status change](../files/statuses.md#previewing-a-status-change)

### What happens when a status request sends both `dryRun` and `confirmVisibilityChange`?

It is a preview. `dryRun` decides, and nothing changes.

More: [Statuses, Edge cases](../files/statuses.md#edge-cases)

### Can the real status change do something else than the preview said?

Yes. A preview answers for the moment it is asked. If files change before
the change is sent, the change does what is true then. Unconfirmed, it is
still refused with `VISIBILITY_CHANGE` when it would make files public.

More: [Statuses, Previewing a status change](../files/statuses.md#previewing-a-status-change)

### Why does the app ask "Change who can open these files?" when I set a status?

The change would make files public, stop public links, or both. The app
says how many, for example "101 files will become public." or "2 public
links will stop working." "Set status" goes ahead. "Cancel" changes nothing.

More: [Statuses, The confirmation](../files/statuses.md#the-confirmation)

### When does the app set a status without asking anything?

When no file would become public and no public link would stop. Then the
status is set at once.

More: [Statuses, The confirmation](../files/statuses.md#the-confirmation)

### What happens when I choose "Cancel" on the status confirmation?

Nothing changes. No file gets the status, however many were selected.

More: [Statuses, The confirmation](../files/statuses.md#the-confirmation)

### Does the app ask once for every batch of 100 files?

No. It asks once, for the whole selection, with the totals. The numbers
count every file of the change, however many batches it takes.

More: [Statuses, The confirmation](../files/statuses.md#the-confirmation)

### What does "A file would now become public, which it would not when you chose. Try again." mean?

No file was to become public when the app read the effect, and one would by
the time the status is set, for example because it was moved into a public
folder meanwhile. The change stops. Files of batches already sent keep the
new status.

More: [Statuses, The confirmation](../files/statuses.md#the-confirmation)

### Why does the app ask before stopping public links when the API does not?

The app asks whenever a change starts or stops public links. The API stops
links without a confirmation and only refuses, until confirmed, a change
that would make files public.

More: [Statuses, Status changes that change access](../files/statuses.md#status-changes-that-change-access)

## Status changes and public links

### What happens to a public link when the file gets a status that does not allow public use?

The link stops at once and answers `404` like a link that never existed. A
file that was public itself has its general access set back to restricted.
A file that was public through a public folder stops being public too.

More: [Statuses, Status changes that change access](../files/statuses.md#status-changes-that-change-access)

### What happens to a public link when I clear the file's status?

The same as with a blocking status: the link stops at once. A file without a
status is never public.

More: [Statuses, Status changes that change access](../files/statuses.md#status-changes-that-change-access)

### Does setting "Approved for public use" on a file make it public?

Not by itself. A file outside any public folder stays restricted until an
owner or admin shares it. A file inside a public folder becomes public
through that folder, after a confirmation.

More: [Statuses, Status changes that change access](../files/statuses.md#status-changes-that-change-access)

### Why did a file become public when I only changed its status?

The file sits in a public folder. With a status that allows public use it is
public through that folder at once. The app asked "Change who can open these
files?" first, and the API refused the change until it was confirmed.

More: [Statuses, Status changes that change access](../files/statuses.md#status-changes-that-change-access)

### I set the status back to an allowing one. Why is the link still dead?

A file's own link that a status change stopped does not return by itself.
The file's general access is restricted from then on. An owner or admin
shares it again, and it then has the same link as before.

More: [Statuses, Status changes that change access](../files/statuses.md#status-changes-that-change-access)

### Do links through a public folder return when the status allows public use again?

Yes, after the confirmation, because the folder is still shared. The file is
public through the folder again, at the same link.

More: [Statuses, Status changes that change access](../files/statuses.md#status-changes-that-change-access)

### Does a CDN keep serving a file after its status stops allowing public use?

No. The stopped links answer `404`, and copies a CDN holds are purged.

More: [Statuses, Status changes that change access](../files/statuses.md#status-changes-that-change-access)

### When does a status change give a file its public link for the first time?

When a file in a public folder gets an allowing status and has never been
public before. It gets its permanent public link at that moment.

More: [Statuses, Status changes that change access](../files/statuses.md#status-changes-that-change-access)

### Does a file leave the public gallery when its status stops allowing public use?

Yes. Its link stops and it leaves the folder's public gallery. The folder
itself stays public.

More: [Statuses, Edge cases](../files/statuses.md#edge-cases)

### Can a status change make a file public that is not in a public folder?

No. An allowing status set on a file outside any public folder works
without a confirmation, and the file stays restricted.

More: [Statuses, Status changes that change access](../files/statuses.md#status-changes-that-change-access)

### What do `becomePublic`, `stopPublic` and `publicVia` read for a refused status change?

`details.becomePublic` counts the files that would become public.
`details.stopPublic` is `0` and `details.publicVia` is `null` for a status
change.

More: [Statuses, Status changes that change access](../files/statuses.md#status-changes-that-change-access)

## Filtering by status

### How do I filter files by status?

In a listing, open "Filter" and choose a status in the group "Status". The
group offers "All statuses", "No status" and then every status in order.

More: [Statuses, The Status filter](../files/statuses.md#the-status-filter)

### How do I find files without a status in the app?

Open "Filter" and choose "No status" in the group "Status".

More: [Statuses, The Status filter](../files/statuses.md#the-status-filter)

### How do I find all files that are not approved yet?

Use "Filter" > "Status" and choose the status new uploads get, or "No
status". The result covers every folder of the open workspace or
organization folder.

More: [Statuses, The Status filter](../files/statuses.md#the-status-filter)

### Does the Status filter look in subfolders?

Yes. With a status chosen, the listing shows the matching files from every
folder of the open workspace or organization folder, not only the open folder.

More: [Statuses, The Status filter](../files/statuses.md#the-status-filter)

### Can I bookmark a file list filtered by status?

Yes. The chosen status is part of the page address, so a filtered listing
can be bookmarked and shared with a colleague.

More: [Statuses, The Status filter](../files/statuses.md#the-status-filter)

### How do I turn the Status filter off?

Choose "All statuses" in the group "Status", or "Clear filters" at the
bottom of the Filter menu, which removes every filter.

More: [Statuses, The Status filter](../files/statuses.md#the-status-filter)

### Can I combine the status filter with other filters?

Yes. The status filter combines with the other filters of a listing.

More: [Statuses, Filtering by status](../files/statuses.md#filtering-by-status)

### What values does `status=` take in a file listing?

A status ID, or `none` for files without a status. Any other value answers
`422 VALIDATION_FAILED` on `status`.

More: [Statuses, Filtering by status](../files/statuses.md#filtering-by-status)

### What does a listing answer when `status=` names a deleted status?

An empty listing. No file has that status. The same holds for the ID of a
status of another workspace, the organization folder or another
organization: no file here can have it.

More: [Statuses, Edge cases](../files/statuses.md#edge-cases)

## Counts and the "Statuses" card

### What does the "Statuses" card show?

How the files of the place you have open split over the statuses of its
workspace or organization folder: a bar and one row per status with its
number of files. It is in the "Details" of a listing and names the place in
its top right corner.

More: [Statuses, The "Statuses" card](../files/statuses.md#the-statuses-card)

### Why are the numbers in the "Statuses" card higher than the files I see in the open folder?

The card counts the open folder together with every folder below it. The
listing shows only the files directly in the folder.

More: [Statuses, The "Statuses" card](../files/statuses.md#the-statuses-card)

### What does the name in the corner of the "Statuses" card mean?

It is the place the card counts: the open folder, the workspace at its top
level, or "Organization folder" at the organization folder's top level.

More: [Statuses, The "Statuses" card](../files/statuses.md#the-statuses-card)

### Does the "Statuses" card count the whole organization?

No. It counts the open folder with the folders below it, or the open
workspace or organization folder at its top level. Nothing adds up the whole
organization: each workspace and the organization folder count their own files.

More: [Statuses, The "Statuses" card](../files/statuses.md#the-statuses-card)

### Does the "Statuses" card of a workspace count organization folder files?

No. A workspace's card counts the workspace's files only, and the
organization folder's card counts the organization folder's files only.

More: [Statuses, The "Statuses" card](../files/statuses.md#the-statuses-card)

### Does a search or a filter change the "Statuses" card?

No. The card keeps counting the open folder, or the whole workspace or
organization folder at the top level.

More: [Statuses, The "Statuses" card](../files/statuses.md#the-statuses-card)

### Why are the numbers in the "Statuses" card dimmed for a moment?

You opened another place. The numbers of the place you came from stay,
dimmed, until the new ones arrive.

More: [Statuses, The "Statuses" card](../files/statuses.md#the-statuses-card)

### Why is a status missing from the "Statuses" card?

No file of the open place has it. The card lists only statuses that have at
least one file there. "No status" is added when some files there have none.

More: [Statuses, The "Statuses" card](../files/statuses.md#the-statuses-card)

### What does "No files yet" mean in the "Statuses" card?

The place you have open holds no files: the open folder and the folders
below it, or the whole workspace or organization folder at its top level.

More: [Statuses, The "Statuses" card](../files/statuses.md#the-statuses-card)

### Do I have to reload to see new counts in the "Statuses" card?

No. The card updates without a reload after an upload, a status change, a
move, a move to the trash and a restore.

More: [Statuses, The "Statuses" card](../files/statuses.md#the-statuses-card)

### How do I count the files with each status in one workspace or folder?

Open it: the "Statuses" card in "Details" counts the open folder with the
folders below it, or the whole workspace or organization folder at its top
level. Through the API or MCP, read `workspace_files_status_count` for a
workspace or `library_files_status_count` for the organization folder (the
API's library). Add
`folderID` to count one folder.

More: [Statuses, Counts for one place](../files/statuses.md#counts-for-one-place)

### Do the status counts of a folder include its subfolders?

Yes. With `folderID` the count covers that folder and every folder below
it. A folder's own `fileCount` counts only the files directly inside it.

More: [Statuses, Counts for one place](../files/statuses.md#counts-for-one-place)

### Do the status counts of one place depend on who asks?

No. Everyone who can read the workspace or the organization folder gets the same
numbers.

More: [Statuses, Counts for one place](../files/statuses.md#counts-for-one-place)

### What does `fileCount` on a status count?

The live files of its workspace or organization folder that have the status.

More: [Statuses, Counts](../files/statuses.md#counts)

### What does `publicFileCount` on a status count?

The files with the status that are public at that moment, themselves or
through a folder. These are the links that stop if the status stops allowing
public use or is deleted.

More: [Statuses, Counts](../files/statuses.md#counts)

### What does `noStatusFileCount` in the status list count?

The live files of the workspace or organization folder without a status.

More: [Statuses, Counts](../files/statuses.md#counts)

### Do my status counts differ from an admin's?

Not `fileCount`, `publicFileCount` or `noStatusFileCount`: they cover only
the list's own workspace or organization folder, and everyone who reads the
list reads the same numbers. Only `trashedFileCount` differs: it is a number
for the owners and admins of the workspace or organization folder in a
browser, and `null` for everyone else.

More: [Statuses, Counts](../files/statuses.md#counts)

### Are files in the trash counted for a status?

Not in `fileCount`, `publicFileCount` or `noStatusFileCount`. They are
counted in `trashedFileCount`.

More: [Statuses, Counts](../files/statuses.md#counts)

### Why is `trashedFileCount` on a status `null`?

It is a number only for an owner or admin of the workspace or organization
folder signed in to the app, who may delete the status. For everyone else,
and for every credential, it is `null`.

More: [Statuses, Counts](../files/statuses.md#counts)

### Do the status counts of an API key cover the whole organization?

No. No status list does: each counts only its own workspace or organization
folder. A credential reads the same counts as a person, except
`trashedFileCount`, which is always `null` for it.

More: [Statuses, Counts](../files/statuses.md#counts)

### Which numbers do the confirmations for deleting a status show?

The counts of the status's workspace or organization folder: the live files
with the status, those of them that are public, and the files in its trash
that have it.

More: [Statuses, Counts](../files/statuses.md#counts)

## Agents and the API

### What is the difference between `workspace_files_status_set` and `library_files_status_set`?

The first sets a status on files of one workspace and takes `workspaceID`.
The second sets one on files of the organization folder and takes
`organizationID`. Both need `files:approve` and take the same `fileIDs`,
`statusID`, `confirmVisibilityChange` and `dryRun`.

More: [Statuses, For agents](../files/statuses.md#for-agents)

### Why does a key with only `files:approve` fail to list the statuses?

`files:approve` does not include reading. Listing the statuses needs
`files:read`, so the call answers `403 FORBIDDEN` with reason
`INSUFFICIENT_SCOPE`. Give the credential `files:read` or `files:write` as
well.

More: [Statuses, For agents](../files/statuses.md#for-agents)

### What does the answer to a status change hold?

`dryRun`, the `status` that was set or `null`, `fileIDs` with each named
file once, `changedFileIDs`, `madePublicFileIDs` and `restrictedFileIDs`.

More: [Statuses, Setting a status on files](../files/statuses.md#setting-a-status-on-files)

### What should an agent do when a status change is refused with `VISIBILITY_CHANGE`?

Nothing changed. Show the count in `details.becomePublic` to the person it
acts for, and repeat the request with `confirmVisibilityChange: true` only
when making those files public is what they want.

More: [Statuses, When files would become public](../files/statuses.md#when-files-would-become-public)

### How can an agent learn what a status change does without triggering `VISIBILITY_CHANGE`?

Send the request with `dryRun: true`. It answers `200` and names the files
that would become public in `madePublicFileIDs`, so the agent can ask the
person before it tries.

More: [Statuses, When files would become public](../files/statuses.md#when-files-would-become-public)

### In what order is a request to set a status checked?

1. Not signed in or an invalid credential: `401 UNAUTHENTICATED`.
2. A credential without `files:approve`: `403`, reason `INSUFFICIENT_SCOPE`.
3. Workspace or organization unknown, deleted or out of reach: `404`.
4. The body is not the expected JSON: `422 VALIDATION_FAILED`.
5. Not an owner or admin there: `403 FORBIDDEN`.
6. A credential whose member has no verified email: `403 EMAIL_NOT_VERIFIED`.
7. Unknown status, or one of another workspace or the organization folder:
   `422` on `statusID`.
8. Not 1 to 100 files: `422` on `fileIDs`.
9. An unknown file: `404 NOT_FOUND`.
10. A file in the trash: `409`, reason `IN_TRASH`.
11. Files would become public, unconfirmed: `409`, reason `VISIBILITY_CHANGE`.

More: [Statuses, Previewing a status change](../files/statuses.md#previewing-a-status-change)

### Why does a status change answer `422` with "Unknown status"?

`statusID` is not a status of the workspace or organization folder in the
path. It is unknown, was deleted, or belongs to another workspace, the
organization folder or another organization. Read the status list of that
workspace or organization folder again for the IDs.

More: [Statuses, Setting a status on files](../files/statuses.md#setting-a-status-on-files)

### Why does a status change answer `404 NOT_FOUND`?

The workspace or organization is unknown, deleted or out of reach, or one of
the files is unknown, in another workspace or deleted for good. No file
changed.

More: [Statuses, Setting a status on files](../files/statuses.md#setting-a-status-on-files)

### Why does a status change answer "name 1 to 100 files"?

`fileIDs` names no file or more than 100. One request sets a status on 1 to
100 files. Send several requests for more.

More: [Statuses, Previewing a status change](../files/statuses.md#previewing-a-status-change)

### Does a status change through an API key record who did it?

Yes. Each file records `file.status_changed` in the audit trail. A change
through a credential is the action of the member the credential acts for.

More: [Statuses, Elsewhere](../files/statuses.md#elsewhere)

### What happens to an agent's status change after its member is made a plain member?

It is refused with `403 FORBIDDEN`. The member's role is checked at each
use, so `files:approve` alone is not enough.

More: [Statuses, Edge cases](../files/statuses.md#edge-cases)

### Why should an agent read the status list before setting a status?

The list gives the IDs to send, and each status's `allowsPublic`. Read the
list of the same workspace or organization folder as the files:
`workspace_file_statuses_list` with `workspaceID`, or
`library_file_statuses_list` with `organizationID`. It is not paged and
holds at most 50 statuses.

More: [Statuses, Reading the list](../files/statuses.md#reading-the-list)

### What do the browser-only status operations take and return?

Adding takes `name` and `allowsPublic` and answers `201` with the status.
Changing takes any of `name`, `allowsPublic`, `isDefault` and
`confirmVisibilityChange` and answers `200` with the status. Reordering
takes `statusIDs` and answers the list. Deleting takes no body and answers
`{"restrictedFileCount": n}`.

More: [Statuses, What the session-only operations take and return](../files/statuses.md#what-the-session-only-operations-take-and-return)

## Approval workflows

### How do I make sure files are reviewed before they can be public?

That is how statuses work from the start. New uploads get the default
status, which never allows public use. An owner or admin gives a file a
status that allows public use, and only then can it be shared.

More: [Statuses, The default status](../files/statuses.md#the-default-status)

### Can I add review steps such as "In review" or "Licensed"?

Yes. Owners and admins of a workspace or the organization folder add
statuses with names of their own, up to 50 in each, and decide for each
whether it allows public use.

More: [Statuses, Adding a status](../files/statuses.md#adding-a-status)

### How do I let someone approve files in one workspace only?

Make them admin or owner of that workspace while they stay a plain member of
the organization. They set statuses on that workspace's files and manage its
status list. They cannot set statuses in the organization folder or manage
the organization folder's list.

More: [Statuses, Who can do what](../files/statuses.md#who-can-do-what)

### How do I withdraw the approval of a file?

Set a status that does not allow public use, or "No status". If the file was
public, its link stops at once. The app asks first and says how many public
links will stop working.

More: [Statuses, Status changes that change access](../files/statuses.md#status-changes-that-change-access)

### How do I withdraw the approval of many files at once?

Select them, or use "Set status" on their folder, and set a status that does
not allow public use. To block every file of one status in one step, choose
"Stop allowing public use" on that status.

More: [Statuses, Setting a status in the app](../files/statuses.md#setting-a-status-in-the-app)

### Can an AI agent do the approving for a team?

Yes, with a credential that holds `files:approve` and acts for an owner or
admin with a verified email. It sets statuses with
`workspace_files_status_set` or `library_files_status_set`, and can preview
each change with `dryRun`.

More: [Statuses, For agents](../files/statuses.md#for-agents)

### Can an agent propose a status for a person to confirm?

Not as a suggestion: a suggestion cannot change a status. An agent with
`files:approve` can send the status change with `dryRun: true`, show the
result to a person and send the change when they agree.

More: [Statuses, Previewing a status change](../files/statuses.md#previewing-a-status-change)

### Can I find out who approved a file?

Each status change is recorded in the audit trail as `file.status_changed`,
with the person. The product itself shows only the activity of API keys and
connected apps, not the whole trail.

More: [Audit trail, Who can do what](../reference/audit-trail.md#who-can-do-what)

### Does approving a file tell the person who uploaded it?

No. No email is sent when a status changes. The uploader sees the new status
on the file.

More: [Statuses, Elsewhere](../files/statuses.md#elsewhere)

### Can I use a status for something other than approval, such as "Archived"?

Yes. A status is a label with a name of your choice. Decide whether it
allows public use. Keep in mind that a file has one status at a time.

More: [Statuses, The status lists](../files/statuses.md#the-status-lists)

### Is a file approved for one workspace approved everywhere?

A file belongs to one workspace or to the organization folder, and its
status is on that file. Each workspace and the organization folder have
their own statuses, and setting a status on one file changes no other file.

More: [Statuses, A file's status](../files/statuses.md#a-files-status)
