Skip to main content
Server path: /box | Type: Application | PCID required: Yes Files, folders, and collaborations

Tools

ToolDescription
box_upload_fileUpload a file to Box from a URL.
box_get_file_infoRetrieve file metadata and information about a file using its ID
box_delete_fileDelete a file from Box by its ID
box_create_folderCreate a new folder within a specified parent folder
box_get_folder_infoRetrieve information about a folder using its ID
box_list_folder_itemsList items (files and folders) in a specified folder
box_move_folderMove a folder to a different parent folder
box_delete_folderDelete a folder from Box by its ID
box_searchSearch for files, folders, and web links across Box content with advanced filtering options. If no query is provided, returns all items from root folder
box_search_foldersSearch for folders that contain the specified query in their name. If no query is provided, returns all folders from root folder
box_get_user_infoGet information about the current authenticated user

box_upload_file

Upload a file to Box from a URL. Parameters:
ParameterTypeRequiredDefaultDescription
fileUrlstringYesURL of the file to upload to Box
parentIdstringYesID of the parent folder (use “0” for root folder)

box_get_file_info

Retrieve file metadata and information about a file using its ID Parameters:
ParameterTypeRequiredDefaultDescription
fileIdstringYesThe unique identifier of the file to retrieve information for

box_delete_file

Delete a file from Box by its ID Parameters:
ParameterTypeRequiredDefaultDescription
fileIdstringYesThe unique identifier of the file to delete

box_create_folder

Create a new folder within a specified parent folder Parameters:
ParameterTypeRequiredDefaultDescription
namestringYesName of the folder to create
parentIdstringYesID of the parent folder (use “0” for root folder)

box_get_folder_info

Retrieve information about a folder using its ID Parameters:
ParameterTypeRequiredDefaultDescription
folderIdstringYesThe unique identifier of the folder to retrieve information for

box_list_folder_items

List items (files and folders) in a specified folder Parameters:
ParameterTypeRequiredDefaultDescription
folderIdstringYesThe unique identifier of the folder to list items from
limitnumberNoMaximum number of items to return
offsetnumberNoNumber of items to skip for pagination

box_move_folder

Move a folder to a different parent folder Parameters:
ParameterTypeRequiredDefaultDescription
folderIdstringYesThe unique identifier of the folder to move
newParentIdstringYesID of the new parent folder

box_delete_folder

Delete a folder from Box by its ID Parameters:
ParameterTypeRequiredDefaultDescription
folderIdstringYesThe unique identifier of the folder to delete
recursivebooleanNofalseWhether to delete folder contents recursively

Search for files, folders, and web links across Box content with advanced filtering options. If no query is provided, returns all items from root folder Parameters:
ParameterTypeRequiredDefaultDescription
querystringNoSearch query string to find items. If not provided, returns all items
typestringNoFilter search results by item type
limitnumberNoMaximum number of results to return
offsetnumberNoNumber of results to skip for pagination
ancestor_folder_idsstring[]NoLimit results to items in specified folders and subfolders
file_extensionsstring[]NoFilter by file extension
content_typesstring[]NoFilter by specific content fields
created_at_rangestringNoLimit results by creation date range
updated_at_rangestringNoLimit results by update date range
size_rangestringNoFilter by file size range
owner_user_idsstring[]NoLimit results by owners
recent_updater_user_idsstring[]NoFilter by users who updated items
trash_contentstringNoDetermine whether to search in trash
mdfiltersstringNoFilter results based on metadata
sortstringNoOrder results by relevance or modification date
directionstringNoSpecify result order direction

box_search_folders

Search for folders that contain the specified query in their name. If no query is provided, returns all folders from root folder Parameters:
ParameterTypeRequiredDefaultDescription
querystringNoSearch query to find folders by name. If not provided, returns all folders
limitnumberNoMaximum number of folder results to return

box_get_user_info

Get information about the current authenticated user