# The organization folder and suggestions: questions and answers

Short answers about the organization folder (the API's library) and about
suggestions: what the organization folder is, who reaches it and how it
differs from a workspace, and what suggestions are, who makes, applies and
rejects them, when they expire and what "Changed since suggested" means.
Each answer links to the section of [The organization folder and
suggestions](../files/library-and-suggestions.md) that owns the rule.

## The organization folder

### What is the organization folder?

A shared place for files that every workspace of the organization uses.
Every organization has exactly one. Every member of the organization reads
it, and only the organization's owners and admins change it.

More: [The organization folder and suggestions, Summary](../files/library-and-suggestions.md#summary)

### What should go into the organization folder?

Files that belong to the whole organization and not to one brand or client:
logos, brand guides, fonts. Put a file there once instead of copying it into
every workspace.

More: [The organization folder and suggestions, Summary](../files/library-and-suggestions.md#summary)

### Does the organization folder belong to one of the workspaces?

No. The organization folder belongs to the organization, not to a workspace.
Every workspace of the organization shows the same organization folder.

More: [The organization folder and suggestions, The organization folder](../files/library-and-suggestions.md#the-organization-folder)

### What does the organization folder hold?

Files with their versions, folders, tags, a trash, uploads and suggestions
of its own, just like a workspace.

More: [The organization folder and suggestions, The organization folder](../files/library-and-suggestions.md#the-organization-folder)

### Can I delete the organization folder?

No. There is no operation that deletes the organization folder. It exists as
long as the organization does.

More: [The organization folder and suggestions, The organization folder](../files/library-and-suggestions.md#the-organization-folder)

### Who can see the files in the organization folder?

Every member of the organization. They list and search its files, open them,
read their versions and download them.

More: [The organization folder and suggestions, The organization folder](../files/library-and-suggestions.md#the-organization-folder)

### Does reading the organization folder need a workspace membership?

No. Reading the organization folder needs only membership of the organization.

More: [The organization folder and suggestions, The organization folder](../files/library-and-suggestions.md#the-organization-folder)

### Who can change the organization folder?

The organization's owners and admins. They upload, rename, describe, tag,
move, trash and restore its files, manage its folders, rename or delete its
tags and manage its statuses and custom fields.

More: [The organization folder and suggestions, The organization folder](../files/library-and-suggestions.md#the-organization-folder)

### Can someone outside the organization tell that its organization folder exists?

No. Someone who is not a member gets `404 NOT_FOUND` for the organization
folder and everything in it, the same answer as for an organization that
does not exist.

More: [The organization folder and suggestions, Who can do what](../files/library-and-suggestions.md#who-can-do-what)

### What happens when a plain member tries to change the organization folder?

The change answers `403 FORBIDDEN` and nothing changes. In the app the
controls that change the organization folder are not offered to a member.

More: [The organization folder and suggestions, The organization folder](../files/library-and-suggestions.md#the-organization-folder)

## The organization folder and workspaces

### How does the organization folder differ from a workspace?

An organization has any number of workspaces and one organization folder. A
workspace is read by its members and changed by everyone who can open it.
The organization folder is read by every member of the organization and
changed only by organization owners and admins. A workspace can be deleted
and restored. The organization folder cannot be deleted.

More: [The organization folder and suggestions, How the organization folder differs from a workspace](../files/library-and-suggestions.md#how-the-organization-folder-differs-from-a-workspace)

### Which role counts in the organization folder?

The role in the organization. In a workspace the effective role in that
workspace counts.

More: [The organization folder and suggestions, How the organization folder differs from a workspace](../files/library-and-suggestions.md#how-the-organization-folder-differs-from-a-workspace)

### I am owner of my workspace. Why can I not upload to the organization folder?

The organization folder belongs to the organization. Only your role in the
organization counts there, and that is member. A role in a workspace gives
nothing in the organization folder.

More: [The organization folder and suggestions, The organization folder](../files/library-and-suggestions.md#the-organization-folder)

### Do uploading, versions, trash and downloading work the same in the organization folder?

Yes. Everything except who may do what works the same way in both. The
operations have the same inputs and the same answers.

More: [The organization folder and suggestions, How the organization folder differs from a workspace](../files/library-and-suggestions.md#how-the-organization-folder-differs-from-a-workspace)

### Do the organization folder and the workspaces share statuses and custom fields?

No. The organization folder and each workspace have their own statuses and
their own custom fields, as they have their own tags. An organization folder
file carries only the organization folder's status and field values; using a
status or field of a workspace on it is refused with `422
VALIDATION_FAILED`. Only the organization's owners and admins manage the
organization folder's, on the pages of **Settings > File spaces > Organization folder**.

More: [The organization folder and suggestions, What the organization folder shares with workspaces, and what it keeps apart](../files/library-and-suggestions.md#what-the-organization-folder-shares-with-workspaces-and-what-it-keeps-apart)

### Are the organization folder's folders visible in a workspace?

No. The organization folder has its own folder tree. A folder of the
organization folder is not listed in any workspace, and a workspace folder
is not listed in the organization folder.

More: [The organization folder and suggestions, What the organization folder shares with workspaces, and what it keeps apart](../files/library-and-suggestions.md#what-the-organization-folder-shares-with-workspaces-and-what-it-keeps-apart)

### Are the organization folder's tags offered in a workspace?

No. A tag belongs to the organization folder or to one workspace. The
organization folder's tags are not offered in a workspace.

More: [The organization folder and suggestions, What the organization folder shares with workspaces, and what it keeps apart](../files/library-and-suggestions.md#what-the-organization-folder-shares-with-workspaces-and-what-it-keeps-apart)

### Can I move a file from my workspace into the organization folder?

No. A file cannot be moved from a workspace into the organization folder,
from the organization folder into a workspace or from one workspace into
another.

More: [The organization folder and suggestions, What the organization folder shares with workspaces, and what it keeps apart](../files/library-and-suggestions.md#what-the-organization-folder-shares-with-workspaces-and-what-it-keeps-apart)

### How do I get a workspace file into the organization folder?

Download the file and have an owner or admin upload it to the organization
folder. That makes a new file there, with its own history and its own link.
The file's details then name the other copy as a duplicate.

More: [The organization folder and suggestions, What the organization folder shares with workspaces, and what it keeps apart](../files/library-and-suggestions.md#what-the-organization-folder-shares-with-workspaces-and-what-it-keeps-apart)

### What happens when a move names a folder of the organization folder as the destination of a workspace file?

It answers `422 VALIDATION_FAILED` and the file stays where it is. Files do
not move between places.

More: [The organization folder and suggestions, What the organization folder shares with workspaces, and what it keeps apart](../files/library-and-suggestions.md#what-the-organization-folder-shares-with-workspaces-and-what-it-keeps-apart)

### Does the organization folder have its own trash?

Yes. Only organization owners and admins trash and restore organization
folder files, and only they delete them for good or empty the organization
folder's trash, in a browser.

More: [The organization folder and suggestions, What the organization folder shares with workspaces, and what it keeps apart](../files/library-and-suggestions.md#what-the-organization-folder-shares-with-workspaces-and-what-it-keeps-apart)

### Can a member star files in the organization folder?

Yes. Favorites are separate and private: each person has their own in the
organization folder and in each workspace. A member who only reads the
organization folder can still star its files and folders.

More: [The organization folder and suggestions, What the organization folder shares with workspaces, and what it keeps apart](../files/library-and-suggestions.md#what-the-organization-folder-shares-with-workspaces-and-what-it-keeps-apart)

### Does an organization folder file show copies of itself that sit in workspaces?

Yes. Duplicates are found across both. A file's details name other live
files with the same content, in the organization folder and in the other
workspaces you can open.

More: [The organization folder and suggestions, What the organization folder shares with workspaces, and what it keeps apart](../files/library-and-suggestions.md#what-the-organization-folder-shares-with-workspaces-and-what-it-keeps-apart)

### How are changes in the organization folder recorded in the audit trail?

For the organization, without a workspace.

More: [The organization folder and suggestions, What the organization folder shares with workspaces, and what it keeps apart](../files/library-and-suggestions.md#what-the-organization-folder-shares-with-workspaces-and-what-it-keeps-apart)

### What happens when an organization folder file's ID is used in a workspace path?

`404 NOT_FOUND`. An organization folder file cannot be read through a
workspace path, and a workspace file cannot be read through the library
path.

More: [The organization folder and suggestions, What the organization folder shares with workspaces, and what it keeps apart](../files/library-and-suggestions.md#what-the-organization-folder-shares-with-workspaces-and-what-it-keeps-apart)

## Opening the organization folder in the app

### Where is the organization folder in the app?

In Files & Assets of any workspace of the organization. The tree "Folders"
starts with the name of the organization, and "Organization folder" is first
below it. Choosing "Organization folder" opens the organization folder.

More: [The organization folder and suggestions, Opening the organization folder](../files/library-and-suggestions.md#opening-the-organization-folder)

### What is the address of the organization folder?

`https://app.usetalewright.com/w/{workspaceID}/files/library`. The workspace
in the address is the one you came from. The organization folder shown is
the same from every workspace.

More: [The organization folder and suggestions, Opening the organization folder](../files/library-and-suggestions.md#opening-the-organization-folder)

### How do I jump to the organization folder with the keyboard?

Run "Go to Organization folder" from the command palette.

More: [The organization folder and suggestions, Opening the organization folder](../files/library-and-suggestions.md#opening-the-organization-folder)

### What does the top level of the organization folder list?

First your workspaces of the organization, as workspace folders marked
"Workspace", then the organization folder's own folders and files. A
workspace folder only opens that workspace's files: it has no menu and
cannot be moved, renamed or deleted there.

More: [The organization folder and suggestions, Opening the organization folder](../files/library-and-suggestions.md#opening-the-organization-folder)

### What do the entries under the organization's name in the folder tree do?

First a workspace folder for each workspace of that organization you can
open; choosing one opens that workspace's files. Then the organization
folder's own folders.

More: [The organization folder and suggestions, Opening the organization folder](../files/library-and-suggestions.md#opening-the-organization-folder)

### What happens when I click the organization's name in the folder tree?

It opens the organization folder: the organization's name is that folder.
Its arrow closes or opens the entries below it.

More: [The organization folder and suggestions, Opening the organization folder](../files/library-and-suggestions.md#opening-the-organization-folder)

### Can I store files directly in the organization?

Yes, in the organization folder, which is the organization's name at the
top of the folder tree. Everyone in the organization can read it; its owners
and admins change it.

More: [The organization folder and suggestions, Opening the organization folder](../files/library-and-suggestions.md#opening-the-organization-folder)

### What does the breadcrumb read in the organization folder?

"Files & Assets", the organization's name, then "Organization folder". The
organization's name is not a link.

More: [The organization folder and suggestions, Opening the organization folder](../files/library-and-suggestions.md#opening-the-organization-folder)

### Who does the card "People" show in the organization folder?

The members of the organization.

More: [The organization folder and suggestions, Opening the organization folder](../files/library-and-suggestions.md#opening-the-organization-folder)

### Which pages does the organization folder have of its own?

"All files" and "Suggestions" in the navigation "Files pages", a "Trash"
page for owners and admins, and its own favorites.

More: [The organization folder and suggestions, Opening the organization folder](../files/library-and-suggestions.md#opening-the-organization-folder)

## What a member sees in the organization folder

### What can a plain member do in the organization folder?

Read it: list and search its files, open them, download them, star them and
read its suggestions. Nothing that changes it is offered.

More: [The organization folder and suggestions, What a member sees in the organization folder](../files/library-and-suggestions.md#what-a-member-sees-in-the-organization-folder)

### Why is there no "Upload" or "New folder" in the organization folder?

You are a plain member of the organization. Ask an owner or admin to add the
file, or to make you an admin.

More: [The organization folder and suggestions, What a member sees in the organization folder](../files/library-and-suggestions.md#what-a-member-sees-in-the-organization-folder)

### Why can I not select files in the organization folder?

You are a plain member of the organization. A member gets no checkboxes to
select files in the organization folder.

More: [The organization folder and suggestions, What a member sees in the organization folder](../files/library-and-suggestions.md#what-a-member-sees-in-the-organization-folder)

### Why does an organization folder file's menu only offer "Open" and "Download"?

You are a plain member. A member's menu has no "Rename", "Move" or "Move to
trash" in the organization folder.

More: [The organization folder and suggestions, What a member sees in the organization folder](../files/library-and-suggestions.md#what-a-member-sees-in-the-organization-folder)

### What happens when a member drops a file on the organization folder page?

It is not uploaded. The command palette offers no "Upload files" either
while the organization folder is open.

More: [The organization folder and suggestions, What a member sees in the organization folder](../files/library-and-suggestions.md#what-a-member-sees-in-the-organization-folder)

### Why is there no "Trash" in the organization folder's navigation for me?

The organization folder's "Trash" page is for owners and admins. Opened by
its address, it shows a member "Only organization owners and admins can
change the organization folder."

More: [The organization folder and suggestions, What a member sees in the organization folder](../files/library-and-suggestions.md#what-a-member-sees-in-the-organization-folder)

### What does an owner or admin see in the organization folder?

The organization folder like a workspace, with every control.

More: [The organization folder and suggestions, What a member sees in the organization folder](../files/library-and-suggestions.md#what-a-member-sees-in-the-organization-folder)

### I was made a plain member while an organization folder page was open. What happens to my next change?

It is refused, and the app says "Only organization owners and admins can
change the organization folder." The role is checked at each change.

More: [The organization folder and suggestions, Edge cases](../files/library-and-suggestions.md#edge-cases)

## Sharing organization folder files

### Can an organization folder file have a public link?

Yes, with the same rule as any file: its status must allow public use, it
must be live, and it or a folder above it must be shared.

More: [The organization folder and suggestions, Public sharing of organization folder files](../files/library-and-suggestions.md#public-sharing-of-organization-folder-files)

### Who can make an organization folder file or folder public?

Organization owners and admins, in a browser. No credential can.

More: [The organization folder and suggestions, Public sharing of organization folder files](../files/library-and-suggestions.md#public-sharing-of-organization-folder-files)

### What does "Every workspace" mean in the organization folder?

The organization folder, or a folder in it, is not public.
Everyone in the organization can open it, from any workspace. It is the
badge of the card "Folder details" where a workspace folder reads
"Restricted". An organization folder file's "Sharing" section says the same
in words: "Only people in the organization can open it."

More: [The organization folder and suggestions, Public sharing of organization folder files](../files/library-and-suggestions.md#public-sharing-of-organization-folder-files)

### What does the badge on a public folder of the organization folder read?

"Public", or "Public, from {folder}" when a folder above shares it.

More: [The organization folder and suggestions, Opening the organization folder](../files/library-and-suggestions.md#opening-the-organization-folder)

## Agents in the organization folder

### Can an agent work in the organization folder?

Yes. Every credential reaches the organization folder of its own
organization, whatever workspaces it is limited to, and reads it with
`files:read`. It changes the organization folder only when its member is an
owner or admin of the organization.

More: [The organization folder and suggestions, Reaching the organization folder](../files/library-and-suggestions.md#reaching-the-organization-folder)

### Can a plain member's agent make a suggestion for the organization folder?

No. The organization folder takes suggestions from owners and admins only. A
plain member's credential gets `403 FORBIDDEN` there, also with
`files:write`.

More: [The organization folder and suggestions, Reaching the organization folder](../files/library-and-suggestions.md#reaching-the-organization-folder)

### Which argument do the `library_` tools take in place of `workspaceID`?

`organizationID`. Inputs and answers are otherwise the same as for the
workspace tools.

More: [The organization folder and suggestions, For agents](../files/library-and-suggestions.md#for-agents)

## Suggestions: the basics

### What is a suggestion?

A batch of proposed changes to files, with a one-line summary, that somebody
prepares and a person reviews. Nothing changes until a person applies it in
the app.

More: [The organization folder and suggestions, Suggestions](../files/library-and-suggestions.md#suggestions)

### What is the difference between a suggestion and a library proposal?

None. "Suggestion" is the word in the app. "Library proposal" is the name in
the API and in MCP.

More: [The organization folder and suggestions, Summary](../files/library-and-suggestions.md#summary)

### Is a "library proposal" only for files in the organization folder?

No. Despite the name, every workspace has them too. A proposal in a
workspace is also called a "library proposal".

More: [The organization folder and suggestions, Summary](../files/library-and-suggestions.md#summary)

### What can a suggestion change?

Tags, the folder a file is in, a file's name and its alt text. Each item
names one file and one of five actions: `add_tag`, `remove_tag`, `move`,
`rename` or `set_alt_text`.

More: [The organization folder and suggestions, What a suggestion can hold](../files/library-and-suggestions.md#what-a-suggestion-can-hold)

### What can a suggestion not change?

A status, general access, a description, a caption, a custom field, a
version or anything outside its place. It cannot trash, restore or delete a
file.

More: [The organization folder and suggestions, Suggestions](../files/library-and-suggestions.md#suggestions)

### Can a suggestion set a custom field or a description?

No. Of a file's descriptions, a suggestion can set only the alt text.

More: [The organization folder and suggestions, Suggestions](../files/library-and-suggestions.md#suggestions)

### Can a suggestion replace a file's content?

No. Applying never touches the file's content or versions.

More: [The organization folder and suggestions, Applying](../files/library-and-suggestions.md#applying)

### Does making a suggestion change any file?

No. Each proposed change waits as an item with the state `pending`.

More: [The organization folder and suggestions, Suggestions](../files/library-and-suggestions.md#suggestions)

### Can one suggestion name files of two workspaces?

No. A suggestion belongs to one place: one workspace, or the organization
folder. Every file it names is in that place.

More: [The organization folder and suggestions, Suggestions](../files/library-and-suggestions.md#suggestions)

### Can a suggestion be edited after it was made?

No. A suggestion cannot be edited or deleted. To change one, reject it and
make a new one. The person applying can still change an item's value before
applying it.

More: [The organization folder and suggestions, Suggestions](../files/library-and-suggestions.md#suggestions)

### How do I withdraw a suggestion?

Reject its pending items. A suggestion cannot be deleted, and it closes when
nothing is pending any more.

More: [The organization folder and suggestions, Suggestions](../files/library-and-suggestions.md#suggestions)

### Does anyone get an email about a new suggestion?

No. It shows in the app at once: as a count on "Suggestions" and as cards
beside the file listing.

More: [The organization folder and suggestions, Making a suggestion](../files/library-and-suggestions.md#making-a-suggestion)

### What are suggestions for?

They are how an agent tidies files without changing anything on its own. The
agent proposes, and a person decides item by item.

More: [The organization folder and suggestions, Summary](../files/library-and-suggestions.md#summary)

## Making a suggestion

### How do I make a suggestion in the app?

You do not. The app reviews suggestions and has no form for making one. They
are made through the REST API or MCP, typically by an agent with a
`files:write` key.

More: [The organization folder and suggestions, Suggestions](../files/library-and-suggestions.md#suggestions)

### Who can make a suggestion in a workspace?

Everyone who can open the workspace. A credential needs `files:write`, and
its member needs that same role.

More: [The organization folder and suggestions, Making a suggestion](../files/library-and-suggestions.md#making-a-suggestion)

### Who can make a suggestion in the organization folder?

Organization owners and admins. A plain member's suggestion for the
organization folder is refused with `403 FORBIDDEN`.

More: [The organization folder and suggestions, Making a suggestion](../files/library-and-suggestions.md#making-a-suggestion)

### What does a suggestion need?

A `summary` of 1 to 500 characters on one line, and 1 to 500 `items`. Each
item names a file, an action and the action's payload.

More: [The organization folder and suggestions, Making a suggestion](../files/library-and-suggestions.md#making-a-suggestion)

### What does an `add_tag` item do when it is applied?

It adds the tag to the file. The tag is created in that place if it does not
exist yet.

More: [The organization folder and suggestions, What a suggestion can hold](../files/library-and-suggestions.md#what-a-suggestion-can-hold)

### What does a `remove_tag` item do when it is applied?

It takes the tag off the file. The tag itself stays in the workspace or
organization folder.

More: [The organization folder and suggestions, What a suggestion can hold](../files/library-and-suggestions.md#what-a-suggestion-can-hold)

### What does a `move` item do when it is applied?

It moves the file into the folder named by `folderPath`, from the top level
down, for example `["Brand", "Logos"]`. Folders that do not exist are
created.

More: [The organization folder and suggestions, What a suggestion can hold](../files/library-and-suggestions.md#what-a-suggestion-can-hold)

### How does a suggestion move a file to the top level?

With an empty `folderPath`: `[]` is the top level.

More: [The organization folder and suggestions, What a suggestion can hold](../files/library-and-suggestions.md#what-a-suggestion-can-hold)

### What does a `set_alt_text` item do when it is applied?

It sets the file's alt text. `null` or blank text clears it.

More: [The organization folder and suggestions, What a suggestion can hold](../files/library-and-suggestions.md#what-a-suggestion-can-hold)

### Can a suggestion hold several changes for the same file?

Yes, also several of the same action. They all apply, one after the other.

More: [The organization folder and suggestions, What a suggestion can hold](../files/library-and-suggestions.md#what-a-suggestion-can-hold)

### In what order are the items of a suggestion shown and applied?

In the order they were sent in.

More: [The organization folder and suggestions, What a suggestion can hold](../files/library-and-suggestions.md#what-a-suggestion-can-hold)

### Why did the tag in my suggestion come back in lower case?

Payloads are stored in their normalized form. A tag is trimmed, its inner
spaces are collapsed and it is put in lower case, so "Logo" is stored as
"logo".

More: [The organization folder and suggestions, What a suggestion can hold](../files/library-and-suggestions.md#what-a-suggestion-can-hold)

### Is a suggestion made in part when one of its items is invalid?

No. One bad item refuses the whole suggestion. A suggestion is made whole or
not at all.

More: [The organization folder and suggestions, Making a suggestion](../files/library-and-suggestions.md#making-a-suggestion)

### Can a suggestion name a file that is in the trash?

No. Every item must name a live file of the same workspace or organization
folder. A file in the trash, a file of another place and an unknown ID are
all refused the same way.

More: [The organization folder and suggestions, Making a suggestion](../files/library-and-suggestions.md#making-a-suggestion)

### What happens when a payload has a key that does not belong to its action?

`422 VALIDATION_FAILED` on `payload`. A payload must fit its action exactly:
a missing key, an extra key or a value of the wrong kind is refused.

More: [The organization folder and suggestions, What a suggestion can hold](../files/library-and-suggestions.md#what-a-suggestion-can-hold)

### What happens when a suggested folder path names 17 folders?

`422 VALIDATION_FAILED` on `payload`. A `folderPath` names at most 16
folders.

More: [The organization folder and suggestions, What a suggestion can hold](../files/library-and-suggestions.md#what-a-suggestion-can-hold)

### Where does the reviewer see the reason for a suggested change?

Under the item. An item can carry a `rationale`, and the app shows it below
the item's sentence.

More: [The organization folder and suggestions, What a suggestion can hold](../files/library-and-suggestions.md#what-a-suggestion-can-hold)

### What does a `requestID` do when a suggestion is made?

It makes a retry safe: a retry with the same `requestID` does not make a
second suggestion. Over REST it is optional. Over MCP it is required.

More: [The organization folder and suggestions, Making a suggestion](../files/library-and-suggestions.md#making-a-suggestion)

### What happens when an agent retries a suggestion with the same `requestID` and body?

Within 24 hours it gets `201` with the suggestion the first request made, as
it is now. No second suggestion is made.

More: [The organization folder and suggestions, Edge cases](../files/library-and-suggestions.md#edge-cases)

### What happens when a `requestID` is reused with a different body?

`409 CONFLICT`, reason `REQUEST_REUSED`. A `requestID` names one request.
Use a new one for a new request.

More: [The organization folder and suggestions, Edge cases](../files/library-and-suggestions.md#edge-cases)

### What does the API answer when a suggestion is made?

`201` with the suggestion and its items. The suggestion is `open`, every
item is `pending`, and `expiresAt` is 14 days after `createdAt`.

More: [The organization folder and suggestions, Making a suggestion](../files/library-and-suggestions.md#making-a-suggestion)

### Who is named as the author of a suggestion an agent made?

The member the credential acts for. `createdBy` holds that member, and the
app shows "suggested by {name}".

More: [The organization folder and suggestions, Make a proposal](../files/library-and-suggestions.md#make-a-proposal)

### What is good practice for an agent that makes suggestions?

Read each file first and send its `lockVersion` as `baseLockVersion`. Write
a `summary` a person understands at a glance, and a `rationale` where the
reason is not obvious. Keep one topic per suggestion.

More: [The organization folder and suggestions, Make a proposal](../files/library-and-suggestions.md#make-a-proposal)

### Should an agent wait in the same call for its suggestion to be applied?

No. The suggestion is applied when a person gets to it, within 14 days, or
not at all.

More: [The organization folder and suggestions, Make a proposal](../files/library-and-suggestions.md#make-a-proposal)

### What happens when two items rename the same file to different names?

Both are accepted. If both are applied, the later item in the suggestion's
order wins.

More: [The organization folder and suggestions, Edge cases](../files/library-and-suggestions.md#edge-cases)

### What happens when an item leaves out `baseLockVersion`?

The file's current `lockVersion` is used. Several items for one file that
leave it out all get the same value, and they still all apply.

More: [The organization folder and suggestions, Making a suggestion](../files/library-and-suggestions.md#making-a-suggestion)

### What happens when an item's `baseLockVersion` is older than the file?

The suggestion is made. The value is not compared when the suggestion is
made. The item ends `stale` when it is applied.

More: [The organization folder and suggestions, Making a suggestion](../files/library-and-suggestions.md#making-a-suggestion)

## States of a suggestion

### What does "Open" mean on a suggestion?

It has not expired, and not every item is decided. Items can be applied and
rejected.

More: [The organization folder and suggestions, States](../files/library-and-suggestions.md#states)

### What does "Closed" mean on a suggestion?

Every item was decided before the suggestion expired. Nothing is left to
apply or reject.

More: [The organization folder and suggestions, States](../files/library-and-suggestions.md#states)

### What does "Expired" mean on a suggestion?

14 days passed while at least one item was still pending. Nothing more of it
can be applied.

More: [The organization folder and suggestions, States](../files/library-and-suggestions.md#states)

### What do "Pending", "Applied" and "Rejected" mean on an item?

"Pending": not decided yet. "Applied": a person applied it, and the file was
changed. "Rejected": somebody rejected it, and the file was not changed.

More: [The organization folder and suggestions, States](../files/library-and-suggestions.md#states)

### Who closes a suggestion?

Nobody by hand. A suggestion closes by itself the moment its last pending
item is applied, rejected or found stale.

More: [The organization folder and suggestions, States](../files/library-and-suggestions.md#states)

### Can a decided item be applied or rejected again?

No. A decided item never changes again. Applying or rejecting an item that
is not pending answers `409 CONFLICT` with reason `ITEM_DECIDED`.

More: [The organization folder and suggestions, States](../files/library-and-suggestions.md#states)

### What do `decidedAt` and `decidedBy` say on an item?

When the item was decided and by whom. Both are `null` while it is pending.

More: [The organization folder and suggestions, States](../files/library-and-suggestions.md#states)

### What is `allowedActions` on a suggestion?

What the caller who reads the suggestion may do to it now. While it is open,
a person in the browser who may decide it sees `["apply", "reject"]`. It is
`[]` once the suggestion is closed or expired.

More: [The organization folder and suggestions, States](../files/library-and-suggestions.md#states)

### Why does my agent see only `["reject"]` in `allowedActions`?

Applying needs a browser. A credential with `files:write` acting for a
person who may decide the suggestion can reject, and cannot apply.

More: [The organization folder and suggestions, States](../files/library-and-suggestions.md#states)

### Why is `allowedActions` empty on an open suggestion?

The caller may not decide it: a credential without `files:write`, or a
member reading an organization folder suggestion.

More: [The organization folder and suggestions, States](../files/library-and-suggestions.md#states)

### What is `closedAt` on a suggestion?

The time its last pending item was decided. It is `null` while items are
pending.

More: [The organization folder and suggestions, States](../files/library-and-suggestions.md#states)

## Expiry

### Can I extend a suggestion beyond its 14 days?

No. The 14 days cannot be extended. Make a new suggestion for what is left.

More: [The organization folder and suggestions, Expiry](../files/library-and-suggestions.md#expiry)

### What happens to a suggestion nobody looks at?

It expires 14 days after it was made. Its undecided items are marked as not
applied and nothing changes.

More: [The organization folder and suggestions, Expiry](../files/library-and-suggestions.md#expiry)

### Why does an expired suggestion still show items as pending?

Pending items are marked `stale` within about an hour after the expiry.
Until that happens they can still read `pending`. They can no longer be
decided.

More: [The organization folder and suggestions, Expiry](../files/library-and-suggestions.md#expiry)

### What happens to items that were applied before a suggestion expired?

They keep their state, and their changes stay. So do items that were
rejected before the expiry.

More: [The organization folder and suggestions, Expiry](../files/library-and-suggestions.md#expiry)

### What does "Expired" mean on an item of a suggestion?

The suggestion expired before anyone decided that item. The file was not
changed. The app uses the word for a pending item of an expired suggestion
and for a stale item nobody decided.

More: [The organization folder and suggestions, Expiry](../files/library-and-suggestions.md#expiry)

### Where did my expired suggestion go?

It is under "Handled" > "Expired" on the Suggestions page. Its address still
opens it, and the API lists it with `state=expired`.

More: [The organization folder and suggestions, "Handled"](../files/library-and-suggestions.md#handled)

### What happens when I try to apply or reject an expired suggestion?

It answers `409 CONFLICT` with reason `CLOSED`. The app says "This
suggestion is closed or expired, so nothing more applies."

More: [The organization folder and suggestions, Expiry](../files/library-and-suggestions.md#expiry)

### Who is `decidedBy` on an item that expired?

Nobody. An item made stale by expiry gets a `decidedAt` but no `decidedBy`,
since no person decided it.

More: [The organization folder and suggestions, Expiry](../files/library-and-suggestions.md#expiry)

### Are the 14 days of a suggestion paused while its workspace is deleted?

No. The suggestions are unreachable with the workspace, and a restore brings
them back, but their 14 days are not paused meanwhile.

More: [The organization folder and suggestions, Edge cases](../files/library-and-suggestions.md#edge-cases)

### Does an expired suggestion ever read `closed`?

No. When its pending items are marked stale, `closedAt` is set, but the
suggestion keeps reading `expired`.

More: [The organization folder and suggestions, Expiry](../files/library-and-suggestions.md#expiry)

## Applying a suggestion

### How do I apply a suggestion?

1. Open "Suggestions" and choose the suggestion.
2. Tick the items to apply. "Select all changes" ticks them all.
3. Choose "Apply". The button reads "Apply 1 change" or "Apply 2 changes".

The page then says what happened, for example "2 applied".

More: [The organization folder and suggestions, Reviewing a suggestion](../files/library-and-suggestions.md#reviewing-a-suggestion)

### Who can apply a suggestion in a workspace?

Everyone who can open the workspace, signed in with a browser.

More: [The organization folder and suggestions, Applying](../files/library-and-suggestions.md#applying)

### Who can apply a suggestion in the organization folder?

The organization's owners and admins, signed in with a browser.

More: [The organization folder and suggestions, Applying](../files/library-and-suggestions.md#applying)

### Do I have to apply every item of a suggestion?

No. Tick the items you want. The others stay pending until someone applies
or rejects them, or the suggestion expires.

More: [The organization folder and suggestions, Applying](../files/library-and-suggestions.md#applying)

### Can I change what is suggested before I apply it?

Yes. Choose "Change it" on the item and type into "New value for {file
name}". The suggestion keeps both what was suggested and what you applied.

More: [The organization folder and suggestions, Reviewing a suggestion](../files/library-and-suggestions.md#reviewing-a-suggestion)

### How do I change the folder of a suggested move before applying it?

Choose "Change it" and type the folder names with `/` between them. An empty
value is the top level. Escape restores the suggested value.

More: [The organization folder and suggestions, Reviewing a suggestion](../files/library-and-suggestions.md#reviewing-a-suggestion)

### What is `appliedPayload` on an item?

What was applied when the person changed the item's value before applying
it. It is kept next to the original `payload`. It is `null` when the item
was applied as suggested.

More: [The organization folder and suggestions, Applying](../files/library-and-suggestions.md#applying)

### In what order are the chosen items applied?

In the suggestion's order, whatever order the request names them in.

More: [The organization folder and suggestions, Applying](../files/library-and-suggestions.md#applying)

### Why is the "Apply" button disabled?

No item is ticked yet. Until then the page says "Select the changes to apply
or reject."

More: [The organization folder and suggestions, Reviewing a suggestion](../files/library-and-suggestions.md#reviewing-a-suggestion)

### What does "Nothing changes until you apply it." mean?

The suggestion has pending items, and none of them has touched a file. Files
change only for the items a person applies.

More: [The organization folder and suggestions, Reviewing a suggestion](../files/library-and-suggestions.md#reviewing-a-suggestion)

### What does "1 applied, 1 changed since suggested" mean after I apply?

One item was applied. The other was not, because its file had changed after
the suggestion was made. That file was left alone.

More: [The organization folder and suggestions, Reviewing a suggestion](../files/library-and-suggestions.md#reviewing-a-suggestion)

### Does applying an item change the file's `lockVersion`?

Yes. Each applied item raises the file's `lockVersion` by one. The item
records the new value as `resultLockVersion`.

More: [The organization folder and suggestions, Applying](../files/library-and-suggestions.md#applying)

### What happens when one of the items I chose is refused?

The whole request changes nothing. No item of it is applied, none is marked
stale, and every chosen item stays pending. Leave the refused item out, or
reject it, and apply the rest.

More: [The organization folder and suggestions, Applying](../files/library-and-suggestions.md#applying)

### Which problems refuse a whole apply request?

A changed value that does not fit its action or breaks a naming rule. A tag
that would give the file more than 50 tags. A move that would make files
public, applied by someone who is not an owner or admin. An item that was
already decided, or that is not an item of this suggestion.

More: [The organization folder and suggestions, Applying](../files/library-and-suggestions.md#applying)

### What does applying a suggestion never do?

It never changes a file's status or its general access setting, a member's
role or anybody's access to a workspace, the file's content or versions, or
a file that is not named by a chosen item.

More: [The organization folder and suggestions, Applying](../files/library-and-suggestions.md#applying)

### Can I undo an applied suggestion?

There is no undo for a suggestion. Each applied item is an ordinary change
to a file: rename it back, move it back or change the tags again.

More: [The organization folder and suggestions, Applying](../files/library-and-suggestions.md#applying)

### What happens when a suggested tag is already on the file?

The item still counts as applied. The tags stay as they are, and the file's
`lockVersion` still rises.

More: [The organization folder and suggestions, Applying](../files/library-and-suggestions.md#applying)

### What happens when a suggestion removes a tag the file does not have?

Nothing is removed, and the item still counts as applied.

More: [The organization folder and suggestions, Applying](../files/library-and-suggestions.md#applying)

### What happens when a suggested tag would be the file's 51st?

The request is refused with `422 VALIDATION_FAILED` on `tags`, and nothing
of it is applied. Free a tag on the file, or leave that item out.

More: [The organization folder and suggestions, Applying](../files/library-and-suggestions.md#applying)

### How does a suggested move find its destination folder?

By its names, from the top level down, ignoring case: "brand" finds the
folder "Brand". A folder on the path that does not exist is created, with
the name as the suggestion spells it.

More: [The organization folder and suggestions, Applying](../files/library-and-suggestions.md#applying)

### Who is the creator of a folder that a suggested move creates?

The person applying the suggestion.

More: [The organization folder and suggestions, Applying](../files/library-and-suggestions.md#applying)

### What happens when a suggested move names a folder that is in the trash?

A new folder with that name is created and the file goes there. Folders in
the trash do not count.

More: [The organization folder and suggestions, Applying](../files/library-and-suggestions.md#applying)

### Do two items that move files to the same new folder create it twice?

No. They create it once.

More: [The organization folder and suggestions, Applying](../files/library-and-suggestions.md#applying)

### Does a suggested rename break the file's public link?

No. The link keeps working. The name in a link is only decoration.

More: [The organization folder and suggestions, Applying](../files/library-and-suggestions.md#applying)

### What happens when two people apply the same item at the same moment?

One applies it. The other gets `409 CONFLICT`, reason `ITEM_DECIDED`, and
nothing of their request is applied.

More: [The organization folder and suggestions, Edge cases](../files/library-and-suggestions.md#edge-cases)

### Why does applying say "Someone decided some of these items already. The list is up to date now."?

Somebody else applied or rejected one of the ticked items first. Nothing of
your request was applied. Tick again and repeat.

More: [The organization folder and suggestions, Reviewing a suggestion](../files/library-and-suggestions.md#reviewing-a-suggestion)

### Can I apply the items of one suggestion over several days?

Yes, within its 14 days. Items that are not chosen stay pending and can be
decided later. Two items for one file both apply, in one go or one after the
other.

More: [The organization folder and suggestions, Applying](../files/library-and-suggestions.md#applying)

### What does the apply operation answer?

`200` with `applied` (how many items were applied), `stale` (how many were
found stale) and the suggestion as it is now.

More: [The organization folder and suggestions, Applying](../files/library-and-suggestions.md#applying)

### What happens when a suggested move names the folder the file is already in?

The item is applied. The file stays where it is.

More: [The organization folder and suggestions, Edge cases](../files/library-and-suggestions.md#edge-cases)

### Is applying a suggestion recorded?

Yes. Each applied item counts as a change by the person who applied it and
is recorded in the audit trail as a file change that names the suggestion.

More: [The organization folder and suggestions, Applying](../files/library-and-suggestions.md#applying)

## Suggested moves and public files

### Can a suggestion make a file public?

Not by itself: it cannot change a status or general access. A move into a
shared folder makes a file public if its status allows public use. Only an
owner or admin can apply such a move.

More: [The organization folder and suggestions, Moves that change access](../files/library-and-suggestions.md#moves-that-change-access)

### What can a member do when a suggested move would make a file public?

Nothing was applied. Untick that move and apply the rest, reject it, or ask
an owner or admin to apply it. The item stays pending meanwhile.

More: [The organization folder and suggestions, Moves that change access](../files/library-and-suggestions.md#moves-that-change-access)

### Does applying a suggested move bring up the question "Change who can open these files?" as well?

No. Applying the suggestion is the confirmation. The person applying sees
each move and its destination, and the move goes ahead without a second
question.

More: [The organization folder and suggestions, Moves that change access](../files/library-and-suggestions.md#moves-that-change-access)

### Can a member apply a suggested move that takes a file out of a public folder?

Yes. A move that only stops public links is applied by everyone who may
apply the suggestion. The file's public link stops.

More: [The organization folder and suggestions, Moves that change access](../files/library-and-suggestions.md#moves-that-change-access)

### Can applying an organization folder suggestion be refused because it makes files public?

No. In the organization folder only owners and admins apply, so that refusal
does not occur there.

More: [The organization folder and suggestions, Moves that change access](../files/library-and-suggestions.md#moves-that-change-access)

## Rejecting

### How do I reject a suggested change?

Choose "Skip" on the item to reject that one item, or tick several and
choose "Reject selected". Their files do not change.

More: [The organization folder and suggestions, Reviewing a suggestion](../files/library-and-suggestions.md#reviewing-a-suggestion)

### What does "Skip" on an item of a suggestion do?

It rejects that one item. The page says "1 rejected".

More: [The organization folder and suggestions, Reviewing a suggestion](../files/library-and-suggestions.md#reviewing-a-suggestion)

### Who can reject items of a suggestion?

In a workspace, everyone who can open it. In the organization folder,
organization owners and admins. A credential with `files:write` can reject,
for a member with that role.

More: [The organization folder and suggestions, Rejecting](../files/library-and-suggestions.md#rejecting)

### Can I reject a suggestion that somebody else made?

Yes. Anyone who may reject can reject any suggestion of that place, not only
their own.

More: [The organization folder and suggestions, Rejecting](../files/library-and-suggestions.md#rejecting)

### Can a rejected item be applied later?

No. Suggest the change again in a new suggestion.

More: [The organization folder and suggestions, Rejecting](../files/library-and-suggestions.md#rejecting)

### How does the API reject everything that is still pending?

Send the reject request with `{}`. Without `itemIDs`, every pending item is
rejected. With `itemIDs`, only those.

More: [The organization folder and suggestions, Reject](../files/library-and-suggestions.md#reject)

### Why does a reject request with an empty `itemIDs` list fail?

`"itemIDs": []` answers `422 VALIDATION_FAILED` on `items`. Leave `itemIDs`
out to reject everything pending.

More: [The organization folder and suggestions, Edge cases](../files/library-and-suggestions.md#edge-cases)

### What happens when the last pending item is rejected?

The suggestion closes.

More: [The organization folder and suggestions, Rejecting](../files/library-and-suggestions.md#rejecting)

### What happens when I reject a suggestion that is already closed?

`409 CONFLICT` with reason `CLOSED`. Naming an item that is already decided
answers `ITEM_DECIDED`, and nothing is rejected.

More: [The organization folder and suggestions, Rejecting](../files/library-and-suggestions.md#rejecting)

## Changed since suggested

### Why was a suggested change not applied to my file?

The file changed after the suggestion was made, or it is in the trash. The
item reads "Changed since suggested", which is the API's `stale`. The file
is as it was.

More: [The organization folder and suggestions, Changed since suggested](../files/library-and-suggestions.md#changed-since-suggested)

### Which changes to a file make its suggested items stale?

Any change that raises its `lockVersion`: renamed, moved, tagged, described,
given a field value, trashed and restored. Also a tag it carries being
renamed or deleted, and a custom field or choice it had a value for being
deleted.

More: [The organization folder and suggestions, Changed since suggested](../files/library-and-suggestions.md#changed-since-suggested)

### Does a new version of a file make its suggested changes stale?

No. A new version does not raise the file's `lockVersion`. Replacing a
file's content alone does not make items stale.

More: [The organization folder and suggestions, Changed since suggested](../files/library-and-suggestions.md#changed-since-suggested)

### A file was trashed and restored before its suggestion was applied. Do the items still apply?

No. They become stale. Trashing and restoring both raise the file's
`lockVersion`.

More: [The organization folder and suggestions, Edge cases](../files/library-and-suggestions.md#edge-cases)

### Can a stale item be applied later?

No. A stale item changed nothing and never will. The way forward is a new
suggestion based on the file as it is now.

More: [The organization folder and suggestions, Changed since suggested](../files/library-and-suggestions.md#changed-since-suggested)

### Why are the later items for the same file stale too?

When one item of a file is stale, later items of the same suggestion for
that file are stale too when they are applied, since the file is no longer
what they expect.

More: [The organization folder and suggestions, Changed since suggested](../files/library-and-suggestions.md#changed-since-suggested)

### Who is recorded on an item that was found stale while applying?

The person who applied. `decidedBy` names them. An item made stale by expiry
has no `decidedBy`.

More: [The organization folder and suggestions, Changed since suggested](../files/library-and-suggestions.md#changed-since-suggested)

### Do two items for the same file make each other stale?

No. Each item expects the `lockVersion` the one before left, so both apply.
The file's `lockVersion` rises by two.

More: [The organization folder and suggestions, Applying](../files/library-and-suggestions.md#applying)

### Somebody edited a file between my two applies. What happens to the second item?

It becomes stale, because the file changed outside the suggestion.

More: [The organization folder and suggestions, Edge cases](../files/library-and-suggestions.md#edge-cases)

## The Suggestions page and cards

### Where do I find suggestions in the app?

Under "Suggestions" in the navigation "Files pages". It opens the
suggestions of the place that is open: the workspace's, or the organization
folder's.

More: [The organization folder and suggestions, The Suggestions page](../files/library-and-suggestions.md#the-suggestions-page)

### What does "Suggestions, 1 open" mean?

The open workspace or organization folder has one open suggestion. The
number counts every open suggestion of the place.

More: [The organization folder and suggestions, The Suggestions page](../files/library-and-suggestions.md#the-suggestions-page)

### What does the number beside "Suggestions" count?

The open suggestions of the place plus its duplicate groups you have not
hidden. With neither, the link shows no number.

More: [The organization folder and suggestions, The Suggestions page](../files/library-and-suggestions.md#the-suggestions-page)

### What does "Suggestions, 1 open, 2 duplicates" mean?

The place has one open suggestion and two duplicate groups you have not
hidden. The number shown beside "Suggestions" is their sum, 3.

More: [The organization folder and suggestions, The Suggestions page](../files/library-and-suggestions.md#the-suggestions-page)

### Why does "Suggestions" show a number when nobody suggested anything?

The place has duplicate files: groups of files with the same bytes that you
have not hidden. Open "Suggestions" and look under "Duplicate files".

More: [The organization folder and suggestions, Duplicate files on the Suggestions page](../files/library-and-suggestions.md#duplicate-files-on-the-suggestions-page)

### How do I open the organization folder's suggestions from any workspace?

Run "Go to Organization folder suggestions" from the command palette.

More: [The organization folder and suggestions, The Suggestions page](../files/library-and-suggestions.md#the-suggestions-page)

### What is "To decide" on the Suggestions page?

A queue of what waits for you, one card at a time: the open suggestions,
newest first, then the duplicate groups you have not hidden. "1 of 4" says
how many there are in all.

More: [The organization folder and suggestions, The queue "To decide"](../files/library-and-suggestions.md#the-queue-to-decide)

### What do "Review", "Hide" and "Not now" do on a card?

"Review" opens the suggestion. "Hide" hides the duplicate warning for you,
as "Hide" in "Duplicate files" does, with "Undo". "Not now" puts the card at
the back of the queue until you leave the page. Nothing about it is saved.

More: [The organization folder and suggestions, The queue "To decide"](../files/library-and-suggestions.md#the-queue-to-decide)

### Which keys work in the queue?

A runs the card's button, "Review" or "Hide". S is "Not now". They work
while no text field, dialog or menu has the keyboard, and the command
palette offers the same commands.

More: [The organization folder and suggestions, The queue "To decide"](../files/library-and-suggestions.md#the-queue-to-decide)

### I chose "Not now" and the card is back. Why?

"Not now" lasts only for this visit to the page. Leave and come back and
the queue starts in its usual order again. Within a visit, a card you put
off comes back once every other card has been put off too.

More: [The organization folder and suggestions, The queue "To decide"](../files/library-and-suggestions.md#the-queue-to-decide)

### Where are closed and expired suggestions?

Under "Handled" below "Duplicate files". It is closed when the page opens;
its number counts both. Inside, "Closed" and "Expired" each list the 50
newest, and "Load more" under a list shows the next 50.

More: [The organization folder and suggestions, "Handled"](../files/library-and-suggestions.md#handled)

### What does "3 items to decide · by Ravi Admin" mean?

The suggestion has three pending items and was made by, or on behalf of,
that member.

More: [The organization folder and suggestions, The queue "To decide"](../files/library-and-suggestions.md#the-queue-to-decide)

### What does "1 applied, 1 rejected, 1 changed since suggested" mean on a closed suggestion?

How its items ended: one was applied, one was rejected and one could not be
applied because its file had changed. The last part is left out when no item
is stale.

More: [The organization folder and suggestions, The Suggestions page](../files/library-and-suggestions.md#the-suggestions-page)

### What does "1 not applied" mean on an expired suggestion?

"Not applied" counts the items nobody decided in time together with those
whose file had changed.

More: [The organization folder and suggestions, The Suggestions page](../files/library-and-suggestions.md#the-suggestions-page)

### What does "Nothing to decide." mean?

No suggestion is open and no duplicate group is left that you have not
hidden, in this workspace or organization folder. Under "Handled", the lists
read "No suggestion has been closed yet." and "No suggestion has expired."
when they are empty.

More: [The organization folder and suggestions, The queue "To decide"](../files/library-and-suggestions.md#the-queue-to-decide)

### What is the page "Suggested file changes"?

The page of one suggestion. Under the title it shows the summary, "suggested
by {name}" and the state. Below are the items, each as one sentence.

More: [The organization folder and suggestions, Reviewing a suggestion](../files/library-and-suggestions.md#reviewing-a-suggestion)

### How does the review page word the items of a suggestion?

As one sentence each, for example "Rename mark.png to Brand mark.png", "Add
tag badges to seal.png", "Move beta.png to Brand / Logos" or "Clear the alt
text of stamp.png".

More: [The organization folder and suggestions, Reviewing a suggestion](../files/library-and-suggestions.md#reviewing-a-suggestion)

### Does an item's sentence show the file's old name or its current one?

The current name.

More: [The organization folder and suggestions, Reviewing a suggestion](../files/library-and-suggestions.md#reviewing-a-suggestion)

### How do decided items look on the review page?

They stay on the page with their state at the end of the row: "Applied",
"Rejected", "Changed since suggested" or "Expired". An applied item reads in
the past tense with the value that was applied, for example "Added tag
emblems to seal.png".

More: [The organization folder and suggestions, Reviewing a suggestion](../files/library-and-suggestions.md#reviewing-a-suggestion)

### Can a member read an organization folder suggestion they cannot apply?

Yes. They see every item and its state, with no checkbox, "Change it",
"Skip", "Apply" or "Reject selected".

More: [The organization folder and suggestions, Reviewing a suggestion](../files/library-and-suggestions.md#reviewing-a-suggestion)

### Does the review page update by itself while I am away from it?

No. The page does not reload when you come back to its window, so the items
stay as you were reviewing them. What others changed shows when you apply.

More: [The organization folder and suggestions, Reviewing a suggestion](../files/library-and-suggestions.md#reviewing-a-suggestion)

### What are the suggestion cards beside the file listing?

One card for each open suggestion of the place that is open. A card is
labelled "Suggestion" and shows the number of pending changes, the summary
and the button "Review".

More: [The organization folder and suggestions, Suggestion cards](../files/library-and-suggestions.md#suggestion-cards)

### What does "2 more suggestions" under the suggestion cards do?

It opens the Suggestions page. At most three cards are shown, newest first.

More: [The organization folder and suggestions, Suggestion cards](../files/library-and-suggestions.md#suggestion-cards)

### Why is there no suggestion card beside my files?

There is no open suggestion in the place that is open. With no open
suggestion there is no card.

More: [The organization folder and suggestions, Suggestion cards](../files/library-and-suggestions.md#suggestion-cards)

## Reading suggestions through the API

### How does an agent find out what became of its suggestion?

It reads the suggestion back. Each item carries its `state`, `decidedAt` and
`decidedBy`, and for an applied item `resultLockVersion` and, if the value
was changed, `appliedPayload`.

More: [The organization folder and suggestions, Read it back](../files/library-and-suggestions.md#read-it-back)

### What does an entry in a list of suggestions hold?

`id`, `summary`, `state`, `allowedActions`, `createdAt`, `createdBy`,
`expiresAt`, `closedAt` and the counts `pending`, `applied`, `rejected` and
`stale`. It does not hold the items.

More: [The organization folder and suggestions, Read it back](../files/library-and-suggestions.md#read-it-back)

### What is `totalCount` in a list of suggestions?

The number of suggestions in the `state` asked for, over all pages. Without
`state` it counts every suggestion of the workspace or organization folder.

More: [The organization folder and suggestions, Read it back](../files/library-and-suggestions.md#read-it-back)

### What is `fileName` on an item of a suggestion?

The file's name now. After a rename is applied, the items of that file show
the new name.

More: [The organization folder and suggestions, Read it back](../files/library-and-suggestions.md#read-it-back)

### Why is a suggestion still `open` after I applied most of it?

At least one item is still pending. A suggestion closes only when no item is
pending any more.

More: [The organization folder and suggestions, Read it back](../files/library-and-suggestions.md#read-it-back)

### What happens when I read a suggestion of another workspace through my own?

`404 NOT_FOUND`, as for an unknown ID. A suggestion belongs to one place.

More: [The organization folder and suggestions, Edge cases](../files/library-and-suggestions.md#edge-cases)

### Can a suggestion be read as an MCP resource?

Yes. A proposal can also be read as an MCP resource, besides the tools that
list and get it.

More: [The organization folder and suggestions, For agents](../files/library-and-suggestions.md#for-agents)

## Duplicate groups

### What is a duplicate group?

A set of live files whose current versions have the same bytes. A workspace
or the organization folder lists a group when one copy is there and you can
open at least two copies in all.

More: [The organization folder and suggestions, Duplicate groups](../files/library-and-suggestions.md#duplicate-groups)

### How do I list every group of duplicate files in a workspace or the organization folder?

Read `GET /v1/workspaces/{workspaceID}/duplicates` or
`GET /v1/organizations/{organizationID}/library/duplicates`, or use the
tools `workspace_duplicates_list` and `library_duplicates_list`.

More: [The organization folder and suggestions, Listing and hiding duplicates](../files/library-and-suggestions.md#listing-and-hiding-duplicates)

### Does a duplicate group include copies in other workspaces?

Yes, when you can open them. A group names the copies of the place first,
then the organization folder's, then those in your other workspaces.

More: [The organization folder and suggestions, Duplicate groups](../files/library-and-suggestions.md#duplicate-groups)

### Can a duplicate group show me a file in a workspace I am not a member of?

No. A copy in a workspace you cannot open is not named and is not counted.

More: [The organization folder and suggestions, Duplicate groups](../files/library-and-suggestions.md#duplicate-groups)

### Are files in the trash part of a duplicate group?

No. Trashing a copy takes it out of its group, and a group left with one
copy is no longer a group.

More: [The organization folder and suggestions, Duplicate groups](../files/library-and-suggestions.md#duplicate-groups)

### How many copies does a duplicate group name?

Up to 20. `fileCount` gives the number of copies you can open.

More: [The organization folder and suggestions, Duplicate groups](../files/library-and-suggestions.md#duplicate-groups)

### In what order are duplicate groups listed?

Newest first: the group whose newest copy was created last leads.

More: [The organization folder and suggestions, Duplicate groups](../files/library-and-suggestions.md#duplicate-groups)

### What do `totalCount` and `hiddenCount` mean in a list of duplicate groups?

`totalCount` is the number of groups you have not hidden. `hiddenCount` is
the number you have. Both cover every page.

More: [The organization folder and suggestions, Duplicate groups](../files/library-and-suggestions.md#duplicate-groups)

### How do I hide a duplicate warning?

In the app, choose "Hide" on the notice "Duplicate" on the file's page, or on
the group under "Duplicate files" on the Suggestions page. Through the API,
send `PUT .../files/{fileID}/duplicates/hidden` for any live copy of the
group. It answers `204`. Either way it hides the warning for you alone.

More: [The organization folder and suggestions, Hiding a duplicate warning](../files/library-and-suggestions.md#hiding-a-duplicate-warning)

### Does hiding a duplicate warning hide it for everyone?

No. Hiding is private. Other people still see the group as not hidden.

More: [The organization folder and suggestions, Hiding a duplicate warning](../files/library-and-suggestions.md#hiding-a-duplicate-warning)

### Why did a duplicate warning I hid come back?

A copy appeared that was not there when you hid the group: a new upload of
the same bytes, a restored copy, or a copy in a workspace you joined since.

More: [The organization folder and suggestions, Hiding a duplicate warning](../files/library-and-suggestions.md#hiding-a-duplicate-warning)

### Does trashing one copy bring back a hidden duplicate warning?

No. A copy that leaves does not end the hide.

More: [The organization folder and suggestions, Hiding a duplicate warning](../files/library-and-suggestions.md#hiding-a-duplicate-warning)

### How do I show a hidden duplicate warning again?

In the app, open "Suggestions", then "Hidden", and choose "Show again" on the
group. Through the API, send `DELETE .../files/{fileID}/duplicates/hidden`
for any live copy of the group. Hidden groups stay in the list with
`hidden: true`.

More: [The organization folder and suggestions, Hiding a duplicate warning](../files/library-and-suggestions.md#hiding-a-duplicate-warning)

### Where do I see every duplicate file of a workspace in the app?

On the workspace's Suggestions page, under "Duplicate files". Each group
names its copies with where they are and links to each file's page. The
organization folder has the same list on its own Suggestions page.

More: [The organization folder and suggestions, Duplicate files on the Suggestions page](../files/library-and-suggestions.md#duplicate-files-on-the-suggestions-page)

### I hid a duplicate warning by mistake. How do I undo it?

Choose "Undo" on the message "Duplicate warning hidden" while it shows.
After that, open "Suggestions", then "Hidden", and choose "Show again".

More: [The organization folder and suggestions, Duplicate files on the Suggestions page](../files/library-and-suggestions.md#duplicate-files-on-the-suggestions-page)

### Where are the duplicate warnings I have hidden?

On the Suggestions page, under "Hidden" below "Duplicate files". It is
closed until you open it and shows how many groups you have hidden.

More: [The organization folder and suggestions, Duplicate files on the Suggestions page](../files/library-and-suggestions.md#duplicate-files-on-the-suggestions-page)

### Does hiding a duplicate warning delete one of the copies?

No. Hiding changes no file. Every copy stays where it is.

More: [The organization folder and suggestions, Hiding a duplicate warning](../files/library-and-suggestions.md#hiding-a-duplicate-warning)

### Does "Hide" on a file's duplicate notice hide it on the other copy too?

Yes. A hide is for the whole group, so the notice is gone from every copy's
page for you.

More: [The organization folder and suggestions, The duplicate notice on a file's page](../files/library-and-suggestions.md#the-duplicate-notice-on-a-files-page)

### What do "2 copies" and "18.4 kB each" mean under "Duplicate files"?

"2 copies" in the column "Copies" says the group holds two files with the
same bytes that you can open. "18.4 kB each" in the column "Size" says each
of them is 18.4 kB.

More: [The organization folder and suggestions, Duplicate files on the Suggestions page](../files/library-and-suggestions.md#duplicate-files-on-the-suggestions-page)

### What does `duplicatesHidden` on a file mean?

That you hid the warning about the file's duplicates and no new copy has
appeared since. The duplicates are still named in `duplicates`.

More: [The organization folder and suggestions, Hiding a duplicate warning](../files/library-and-suggestions.md#hiding-a-duplicate-warning)

### Can a member who only reads the organization folder hide a duplicate warning there?

Yes. Everyone who can read a place can hide there.

More: [The organization folder and suggestions, Hiding a duplicate warning](../files/library-and-suggestions.md#hiding-a-duplicate-warning)

### Can an agent hide a duplicate warning over MCP?

No. Hiding and showing are REST operations, not tools. An agent lists the
groups with `workspace_duplicates_list` and `library_duplicates_list`.

More: [The organization folder and suggestions, Listing and hiding duplicates](../files/library-and-suggestions.md#listing-and-hiding-duplicates)

### Which scope does a credential need to list duplicate groups or hide a warning?

`files:read`. Hiding changes nothing for anyone but the credential's member.

More: [The organization folder and suggestions, Listing and hiding duplicates](../files/library-and-suggestions.md#listing-and-hiding-duplicates)

### Is hiding a duplicate warning recorded in the audit trail?

No. It is a personal preference and changes no file.

More: [The organization folder and suggestions, Hiding a duplicate warning](../files/library-and-suggestions.md#hiding-a-duplicate-warning)
