public_shared_links
Scan Box folders to list files and folders whose shared links are open to anyone with the URL, identifying exposed sharing risks.
Instructions
List items with an open ("anyone with the link") shared link (enumeration).
Walks folders the authenticating co-admin user can see and reports files and
folders whose shared link access is open — reachable by anyone with the
URL, the highest-exposure sharing mode.
Args:
root_folder_id: Folder to start from ("0" = the user's root). A Box
folder id: decimal digits only, as shown at the end of a Box folder
URL. Anything else is refused with {"error": ...} before any
request is made, rather than being reported as an empty result.
max_folders: Cap on folders visited (default 150); capped discloses truncation.
max_depth: Folder recursion depth (default 1 = top-level only; raise to reach file links inside folders).
Coverage note: limited to content the co-admin user can access and to the
caps. Returns folders_scanned, capped, fetch_errors (count of
folders whose lookup hit an API error; coverage is complete only when
capped is false AND fetch_errors is 0), count, and
public_shared_links (item type/id/name, owner, access, can_download). On
failure returns {"error": ...}.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| max_depth | No | ||
| max_folders | No | ||
| root_folder_id | No | 0 |