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 that owns the rule.
The organization folder
- What is the organization folder?
- What should go into the organization folder?
- Does the organization folder belong to one of the workspaces?
- What does the organization folder hold?
- Can I delete the organization folder?
- Who can see the files in the organization folder?
- Does reading the organization folder need a workspace membership?
- Who can change the organization folder?
- Can someone outside the organization tell that its organization folder exists?
- What happens when a plain member tries to change the organization folder?
The organization folder and workspaces
- How does the organization folder differ from a workspace?
- Which role counts in the organization folder?
- I am owner of my workspace. Why can I not upload to the organization folder?
- Do uploading, versions, trash and downloading work the same in the organization folder?
- Do the organization folder and the workspaces share statuses and custom fields?
- Are the organization folder's folders visible in a workspace?
- Are the organization folder's tags offered in a workspace?
- Can I move a file from my workspace into the organization folder?
- How do I get a workspace file into the organization folder?
- What happens when a move names a folder of the organization folder as the destination of a workspace file?
- Does the organization folder have its own trash?
- Can a member star files in the organization folder?
- Does an organization folder file show copies of itself that sit in workspaces?
- How are changes in the organization folder recorded in the audit trail?
- What happens when an organization folder file's ID is used in a workspace path?
Opening the organization folder in the app
- Where is the organization folder in the app?
- What is the address of the organization folder?
- How do I jump to the organization folder with the keyboard?
- What does the top level of the organization folder list?
- What do the entries under the organization's name in the folder tree do?
- What happens when I click the organization's name in the folder tree?
- Can I store files directly in the organization?
- What does the breadcrumb read in the organization folder?
- Who does the card "People" show in the organization folder?
- Which pages does the organization folder have of its own?
What a member sees in the organization folder
- What can a plain member do in the organization folder?
- Why is there no "Upload" or "New folder" in the organization folder?
- Why can I not select files in the organization folder?
- Why does an organization folder file's menu only offer "Open" and "Download"?
- What happens when a member drops a file on the organization folder page?
- Why is there no "Trash" in the organization folder's navigation for me?
- What does an owner or admin see in the organization folder?
- I was made a plain member while an organization folder page was open. What happens to my next change?
Sharing organization folder files
Agents in the organization folder
Suggestions: the basics
- What is a suggestion?
- What is the difference between a suggestion and a library proposal?
- Is a "library proposal" only for files in the organization folder?
- What can a suggestion change?
- What can a suggestion not change?
- Can a suggestion set a custom field or a description?
- Can a suggestion replace a file's content?
- Does making a suggestion change any file?
- Can one suggestion name files of two workspaces?
- Can a suggestion be edited after it was made?
- How do I withdraw a suggestion?
- Does anyone get an email about a new suggestion?
- What are suggestions for?
Making a suggestion
- How do I make a suggestion in the app?
- Who can make a suggestion in a workspace?
- Who can make a suggestion in the organization folder?
- What does a suggestion need?
- What does an
add_tagitem do when it is applied? - What does a
remove_tagitem do when it is applied? - What does a
moveitem do when it is applied? - How does a suggestion move a file to the top level?
- What does a
set_alt_textitem do when it is applied? - Can a suggestion hold several changes for the same file?
- In what order are the items of a suggestion shown and applied?
- Why did the tag in my suggestion come back in lower case?
- Is a suggestion made in part when one of its items is invalid?
- Can a suggestion name a file that is in the trash?
- What happens when a payload has a key that does not belong to its action?
- What happens when a suggested folder path names 17 folders?
- Where does the reviewer see the reason for a suggested change?
- What does a
requestIDdo when a suggestion is made? - What happens when an agent retries a suggestion with the same
requestIDand body? - What happens when a
requestIDis reused with a different body? - What does the API answer when a suggestion is made?
- Who is named as the author of a suggestion an agent made?
- What is good practice for an agent that makes suggestions?
- Should an agent wait in the same call for its suggestion to be applied?
- What happens when two items rename the same file to different names?
- What happens when an item leaves out
baseLockVersion? - What happens when an item's
baseLockVersionis older than the file?
States of a suggestion
- What does "Open" mean on a suggestion?
- What does "Closed" mean on a suggestion?
- What does "Expired" mean on a suggestion?
- What do "Pending", "Applied" and "Rejected" mean on an item?
- Who closes a suggestion?
- Can a decided item be applied or rejected again?
- What do
decidedAtanddecidedBysay on an item? - What is
allowedActionson a suggestion? - Why does my agent see only
["reject"]inallowedActions? - Why is
allowedActionsempty on an open suggestion? - What is
closedAton a suggestion?
Expiry
- Can I extend a suggestion beyond its 14 days?
- What happens to a suggestion nobody looks at?
- Why does an expired suggestion still show items as pending?
- What happens to items that were applied before a suggestion expired?
- What does "Expired" mean on an item of a suggestion?
- Where did my expired suggestion go?
- What happens when I try to apply or reject an expired suggestion?
- Who is
decidedByon an item that expired? - Are the 14 days of a suggestion paused while its workspace is deleted?
- Does an expired suggestion ever read
closed?
Applying a suggestion
- How do I apply a suggestion?
- Who can apply a suggestion in a workspace?
- Who can apply a suggestion in the organization folder?
- Do I have to apply every item of a suggestion?
- Can I change what is suggested before I apply it?
- How do I change the folder of a suggested move before applying it?
- What is
appliedPayloadon an item? - In what order are the chosen items applied?
- Why is the "Apply" button disabled?
- What does "Nothing changes until you apply it." mean?
- What does "1 applied, 1 changed since suggested" mean after I apply?
- Does applying an item change the file's
lockVersion? - What happens when one of the items I chose is refused?
- Which problems refuse a whole apply request?
- What does applying a suggestion never do?
- Can I undo an applied suggestion?
- What happens when a suggested tag is already on the file?
- What happens when a suggestion removes a tag the file does not have?
- What happens when a suggested tag would be the file's 51st?
- How does a suggested move find its destination folder?
- Who is the creator of a folder that a suggested move creates?
- What happens when a suggested move names a folder that is in the trash?
- Do two items that move files to the same new folder create it twice?
- Does a suggested rename break the file's public link?
- What happens when two people apply the same item at the same moment?
- Why does applying say "Someone decided some of these items already. The list is up to date now."?
- Can I apply the items of one suggestion over several days?
- What does the apply operation answer?
- What happens when a suggested move names the folder the file is already in?
- Is applying a suggestion recorded?
Suggested moves and public files
- Can a suggestion make a file public?
- What can a member do when a suggested move would make a file public?
- Does applying a suggested move bring up the question "Change who can open these files?" as well?
- Can a member apply a suggested move that takes a file out of a public folder?
- Can applying an organization folder suggestion be refused because it makes files public?
Rejecting
- How do I reject a suggested change?
- What does "Skip" on an item of a suggestion do?
- Who can reject items of a suggestion?
- Can I reject a suggestion that somebody else made?
- Can a rejected item be applied later?
- How does the API reject everything that is still pending?
- Why does a reject request with an empty
itemIDslist fail? - What happens when the last pending item is rejected?
- What happens when I reject a suggestion that is already closed?
Changed since suggested
- Why was a suggested change not applied to my file?
- Which changes to a file make its suggested items stale?
- Does a new version of a file make its suggested changes stale?
- A file was trashed and restored before its suggestion was applied. Do the items still apply?
- Can a stale item be applied later?
- Why are the later items for the same file stale too?
- Who is recorded on an item that was found stale while applying?
- Do two items for the same file make each other stale?
- Somebody edited a file between my two applies. What happens to the second item?
The Suggestions page and cards
- Where do I find suggestions in the app?
- What does "Suggestions, 1 open" mean?
- What does the number beside "Suggestions" count?
- What does "Suggestions, 1 open, 2 duplicates" mean?
- Why does "Suggestions" show a number when nobody suggested anything?
- How do I open the organization folder's suggestions from any workspace?
- What is "To decide" on the Suggestions page?
- What do "Review", "Hide" and "Not now" do on a card?
- Which keys work in the queue?
- I chose "Not now" and the card is back. Why?
- Where are closed and expired suggestions?
- What does "3 items to decide ยท by Ravi Admin" mean?
- What does "1 applied, 1 rejected, 1 changed since suggested" mean on a closed suggestion?
- What does "1 not applied" mean on an expired suggestion?
- What does "Nothing to decide." mean?
- What is the page "Suggested file changes"?
- How does the review page word the items of a suggestion?
- Does an item's sentence show the file's old name or its current one?
- How do decided items look on the review page?
- Can a member read an organization folder suggestion they cannot apply?
- Does the review page update by itself while I am away from it?
- What are the suggestion cards beside the file listing?
- What does "2 more suggestions" under the suggestion cards do?
- Why is there no suggestion card beside my files?
Reading suggestions through the API
- How does an agent find out what became of its suggestion?
- What does an entry in a list of suggestions hold?
- What is
totalCountin a list of suggestions? - What is
fileNameon an item of a suggestion? - Why is a suggestion still
openafter I applied most of it? - What happens when I read a suggestion of another workspace through my own?
- Can a suggestion be read as an MCP resource?
Duplicate groups
- What is a duplicate group?
- How do I list every group of duplicate files in a workspace or the organization folder?
- Does a duplicate group include copies in other workspaces?
- Can a duplicate group show me a file in a workspace I am not a member of?
- Are files in the trash part of a duplicate group?
- How many copies does a duplicate group name?
- In what order are duplicate groups listed?
- What do
totalCountandhiddenCountmean in a list of duplicate groups? - How do I hide a duplicate warning?
- Does hiding a duplicate warning hide it for everyone?
- Why did a duplicate warning I hid come back?
- Does trashing one copy bring back a hidden duplicate warning?
- How do I show a hidden duplicate warning again?
- Where do I see every duplicate file of a workspace in the app?
- I hid a duplicate warning by mistake. How do I undo it?
- Where are the duplicate warnings I have hidden?
- Does hiding a duplicate warning delete one of the copies?
- Does "Hide" on a file's duplicate notice hide it on the other copy too?
- What do "2 copies" and "18.4 kB each" mean under "Duplicate files"?
- What does
duplicatesHiddenon a file mean? - Can a member who only reads the organization folder hide a duplicate warning there?
- Can an agent hide a duplicate warning over MCP?
- Which scope does a credential need to list duplicate groups or hide a warning?
- Is hiding a duplicate warning recorded in the audit trail?