Powerful automation workflows you can set up in minutes with AI agents.
Files uploaded to a deal folder in Box call Add shared link to file, then the link is written back to the HubSpot deal as a custom property.
“Box file uploaded to deal then Add shared link returns URL.”
DocuSign completed events call Apply watermark to file in Box so executed contracts carry a signed mark, satisfying audit and compliance reviews.
“DocuSign contract signed then Apply watermark to file runs.”
Gmail attachments saved to Box call Add classification to file based on sender domain, enforcing DLP policies without asking users to tag manually.
“Gmail attachment saved then Add classification to file applied.”
An event occurs in Box or a connected app that starts your automation.
The AI agent analyzes the data, makes intelligent decisions, and determines the best actions.
The agent executes actions in Box and other tools — no manual work required.
Box simplifies workflows, while Arahi AI empowers these tasks with AI agents.
Save attachments from Gmail or Outlook into the right Box folder with auto-tagged naming.
Route new Box uploads through a review and approval chain before they're shared externally.
Back up critical data to Box nightly with age-based retention — no manual cleanup sweep.
Expire public Box share links after N days automatically so nothing stays exposed.
Ready-to-use Box actions you can add to your agents instantly.
Custom API calls to Box with full control for advanced use cases.
Sign in to your Arahi AI account and navigate to integrations or create a new AI agent.
A secure pop-up will ask you to log in. This authorizes Arahi AI to access your API using OAuth.
Choose "Box" from the tool list, then select the action you want to perform.
Test your automation with sample data, then deploy it to run on schedule or by event.
The integration uses secure OAuth authentication, ensuring only authorized workflows access your Box data.
Your data remains private and is never used for model training.
We never store anything we don't need to. Inputs and outputs of your tools are never stored.
Platform for secure content management, workflow, and collaboration With Arahi AI, you can connect Box to AWS, Dropbox, Google Cloud and 1,500+ other apps using AI-powered workflows. No coding required — set up triggers, actions, and intelligent automation in minutes.
As a file storage tool, Box connects with other file storage apps like AWS, Dropbox, Google Cloud, Google Drive through Arahi AI's integration platform. Build multi-step automations that combine Box with AI-powered decision making, data transformation, and cross-app orchestration.
Every item is a real, named endpoint from Box's API. Your agent can watch events and run 273 actions — no glue code.
Things the agent can do
Adds a classification to a file by specifying the label of the classification to add. this api can also be called by including the enterprise id in the url explicitly, for exampl…
Adds a classification to a folder by specifying the label of the classification to add. this api can also be called by including the enterprise id in the url explicitly, for exam…
Creates a new entry in the list of allowed domains to allow collaboration for.
When an enterprise does not yet have any classifications, this api call initializes the classification template with an initial set of classifications. if an enterprise already h…
Adds or updates a user avatar.
Adds a shared link to a file.
Adds a shared link to a folder.
Adds a shared link to a web link.
Creates a group membership. only users with admin-level permissions will be able to use this api.
Applies or update a watermark on a file.
Applies or update a watermark on a folder.
Sends an ai request to supported llms and returns an answer specifically focused on the user's question given the provided context.
Assign a legal hold to a file, file version, folder, or user.
Assigns a retention policy to an item.
Creates a storage policy assignment for an enterprise or user.
Assigns a task to a user. a task can be assigned to more than one user by creating multiple assignments.
Authorize a user by sending them through the [box](https://box.com) website and request their permission to act on their behalf. this is the first step when authenticating a user…
Cancels a sign request.
Change status of shield information barrier with the specified id.
Close an upload session and create a file from the uploaded chunks. the actual endpoint url is returned by the [`create upload session`](e://post-files-upload-sessions) and [`get…
Creates a copy of a file.
Copies an existing file request that is already present on one folder, and applies it to another folder.
Creates a copy of a folder within a destination folder. the original folder will not be changed.
Creates an ai agent. at least one of the following capabilities must be provided: `ask`, `text gen`, `extract`.
Creates a signature request. this involves preparing a document for signing and sending the signature request to signers.
Applies one or more box skills metadata cards to a file.
Adds a collaboration for a single user or a single group to a file or folder. collaborations can be created using email address, user ids, or a group ids. if a collaboration is b…
Adds a comment by the user to a specific file, or as a reply to an other comment.
Adds a new email alias to a user account..
Creates a new empty folder within the specified parent folder.
Creates a folder lock on a folder, preventing it from being moved and/or deleted. you must be authenticated as the owner or co-owner of the folder to use this endpoint.
Creates a new group of users in an enterprise. only users with admin permissions can create new groups.
Validates the roles and permissions of the group, and creates asynchronous jobs to terminate the group's sessions. returns the status for the post request.
Validates the roles and permissions of the user, and creates asynchronous jobs to terminate the user's sessions. returns the status for the post request.
Create a new legal hold policy.
Creates a new metadata cascade policy that applies a given metadata template to a given folder and automatically cascades it down to any files within that folder. in order for th…
Applies an instance of a metadata template to a file. in most cases only values that are present in the metadata template will be accepted, except for the `global.properties` tem…
Applies an instance of a metadata template to a folder. in most cases only values that are present in the metadata template will be accepted, except for the `global.properties` t…
Creates a new metadata template that can be applied to files and folders.
Creates a retention policy.
Creates a shield information barrier to separate individuals/groups within the same firm and prevents confidential information passing between them.
Creates a shield information barrier report for a given barrier.
Creates a shield information barrier segment.
Creates a new shield information barrier segment member.
Creates a shield information barrier segment restriction object.
Creates a [slack integration mapping](https://support.box.com/hc/en-us/articles/4415585987859-box-as-the-content-layer-for-slack) by mapping a slack channel to a box item. you ne…
Creates a single task on a file. this task is not assigned to any user and will need to be assigned separately.
Creates a [teams integration mapping](https://support.box.com/hc/en-us/articles/360044681474-using-box-for-teams) by mapping a teams channel to a box item. you need admin or co-a…
Creates a terms of service for a given enterprise and type of user.
Sets the status for a terms of service for a user.
Creates an upload session for a new file.
Creates an upload session for an existing file.
Creates a new managed user in an enterprise. this endpoint is only available to users and applications with the right admin permissions.
Create user exemption from collaboration domain restrictions.
Invites an existing external user to join an enterprise. the existing user can not be part of another enterprise and must already have a box account. once invited, the user will …
Creates a webhook.
Creates a web link object within a folder.
Creates a request to download multiple files and folders as a single `zip` archive file. this api does not return the archive but instead performs all the checks to ensure that t…
Deletes an ai agent using the provided parameters.
Deletes a file, either permanently or by moving it to the trash. the the enterprise settings determine whether the item will be permanently deleted from box or moved to the trash.
Deletes a file request permanently.
Deletes a folder, either permanently or by moving it to the trash.
Deletes a folder lock on a given folder. you must be authenticated as the owner or co-owner of the folder to use this endpoint.
Permanently deletes a retention policy.
Deletes the shield information barrier segment based on provided id.
Deletes a shield information barrier segment member based on provided id.
Delete shield information barrier segment restriction by id.
Deletes a [slack integration mapping](https://support.box.com/hc/en-us/articles/4415585987859-box-as-the-content-layer-for-slack). you need admin or co-admin role to use this end…
Deletes a [teams integration mapping](https://support.box.com/hc/en-us/articles/360044681474-using-box-for-teams). you need admin or co-admin role to use this endpoint.
Deletes a user. by default this will fail if the user still owns any content. move their owned content first before proceeding, or use the `force` field to delete the user and th…
Removes an existing user avatar. you cannot reverse this operation.
Returns the contents of a file in binary format.
Returns the contents of a `zip` archive in binary format. this url does not require any form of authentication and could be used in a user's browser to download the archive to a …
Sends an ai request to supported large language models (llms) and extracts metadata in form of key-value pairs. in this request, both the prompt and the output can be freeform. m…
Sends an ai request to supported large language models (llms) and returns extracted metadata as a set of key-value pairs. for this request, you either need a metadata template or…
Returns the app item represented by a shared link. the link can originate from the current enterprise or another.
Returns the file represented by a shared link. a shared file can be represented by a shared link, which can originate within the current enterprise or within another. this endpoi…
Return the folder represented by a shared link. a shared folder can be represented by a shared link, which can originate within the current enterprise or within another. this end…
Finds a metadata template by searching for the id of an instance of the template.
Returns the web link represented by a shared link. a shared web link can be represented by a shared link, which can originate within the current enterprise or within another. thi…
Force the metadata on a folder with a metadata cascade policy to be applied to all of its children. this can be used after creating a new cascade policy to enforce the metadata t…
Sends an ai request to supported large language models (llms) and returns generated text based on the provided prompt.
Gets an ai agent using the `agent id` parameter.
Get the ai agent default config
Returns a domain that has been deemed safe to create collaborations for within the current enterprise.
Gets a sign request by id.
Fetches details of a specific box sign template.
Retrieves the classification metadata instance that has been applied to a file. this api can also be called by including the enterprise id in the url explicitly, for example `/fi…
Retrieves the classification metadata instance that has been applied to a folder. this api can also be called by including the enterprise id in the url explicitly, for example `/…
Retrieves a single collaboration.
Retrieves a collection by its id.
Retrieves the message and metadata for a specific comment, as well as information on the user who created the comment.
Retrieves information about the user who is currently authenticated. in the case of a client-side authenticated oauth 2.0 application this will be the user who authorized the app…
Retrieves information about an individual device pin.
The listevents endpoint provides information about the events available in the box system. this options method allows developers to discover the capabilities and requirements for…
Retrieves the details about a file.
Retrieves the information about a file request.
Returns a list of files under retention for a retention policy assignment.
Retrieves a thumbnail, or smaller image representation, of a file. sizes of `32x32`,`64x64`, `128x128`, and `256x256` can be returned in the `.png` format and sizes of `32x32`, `…
Retrieve a specific version of a file. versions are only tracked for box users with premium accounts.
Retrieves information about the legal hold policies assigned to a file version.
Returns a list of file versions under retention for a retention policy assignment.
Retrieves details for a folder, including the first 100 entries in the folder. passing `sort`, `direction`, `offset`, and `limit` parameters in query allows you to manage the lis…
Retrieves information about a group. only members of this group or users with admin-level permissions will be able to use this api.
Retrieves a specific group membership. only admins of this group or users with admin-level permissions will be able to use this api.
Retrieve a legal hold policy.
Retrieve a legal hold policy assignment.
Retrieve a specific metadata cascade policy assigned to a folder.
Retrieves the instance of a metadata template that has been applied to a file.
Retrieves the instance of a metadata template that has been applied to a folder. this can not be used on the root folder with id `0`.
Retrieves a metadata template by its id.
Retrieves a metadata template by its `scope` and `templatekey` values. to find the `scope` and `templatekey` for a template, list all templates for an enterprise or globally, or …
Returns information about a file version retention. **note**: file retention api is now **deprecated**. to get information about files and file versions under retention, see [fil…
Retrieves a retention policy.
Retrieves a retention policy assignment
Gets the information for a shared link on a file.
Gets the information for a shared link on a folder.
Gets the information for a shared link on a web link.
Retrieves a shield information barrier report by its id.
Retrieves a shield information barrier segment member by its id.
Retrieves a shield information barrier segment restriction based on provided id.
Retrieves shield information barrier segment based on provided id..
Get shield information barrier based on provided id.
Fetches a specific storage policy.
Fetches a specific storage policy assignment.
Retrieves information about a specific task.
Retrieves information about a task assignment.
Fetches a specific terms of service.
Retrieves a file that has been moved to the trash. please note that only if the file itself has been moved to the trash can it be retrieved with this api call. if instead one of …
Retrieves a folder that has been moved to the trash. please note that only if the folder itself has been moved to the trash can it be retrieved with this api call. if instead one…
Retrieves a web link that has been moved to the trash.
Return information about an upload session. the actual endpoint url is returned by the [`create upload session`](e://post-files-upload-sessions) endpoint.
Retrieves information about a user in the enterprise. the application and the authenticated user need to have the permission to look up users in the entire enterprise. this endpo…
Retrieves an image of a the user's avatar.
Returns a users who has been exempt from the collaboration domain restrictions.
Returns the status of a user invite.
Retrieve the watermark for a folder.
Retrieve the watermark for a file.
Retrieves a specific webhook
Retrieve information about a web link.
Returns the download status of a `zip` archive, allowing an application to inspect the progress of the download as well as the number of items that might have been skipped. this …
Lists ai agents based on the provided parameters.
Retrieves the classification metadata template and lists all the classifications available to this enterprise. this api can also be called by including the enterprise id in the u…
Retrieves all collections for a given user. currently, only the `favorites` collection is supported.
Retrieve a list of the past versions for a file. versions are only tracked by box users with premium accounts. to fetch the id of the current version of a file, use the `get /fil…
Used to retrieve all generic, global metadata templates available to all enterprises using box.
Retrieves a list of legal hold policies that belong to an enterprise.
Used to retrieve all metadata templates created to be used specifically within the user's enterprise
Returns the list domains that have been deemed safe to create collaborations for within the current enterprise.
Returns all defined webhooks for the requesting application. this api only returns webhooks that are applied to files or folders that are owned by the authenticated user. this me…
Gets signature requests created by a user. if the `sign files` and/or `parent folder` are deleted, the signature request will not return in the list.
Gets box sign templates created by a user.
List the box skills metadata cards that are attached to a file.
Retrieves the files and/or folders contained within this collection.
Retrieves all the device pins within an enterprise. the user must have admin privileges, and the application needs the \
Returns a list of all users for the enterprise along with their `user id`, `public name`, and `login`. the application and the authenticated user need to have the permission to l…
**this is a beta feature, which means that its availability might be limited.** returns all app items the file is associated with. this includes app items associated with ancesto…
Retrieves a list of pending and active collaborations for a file. this returns all the users that have access to the file or have been invited to the file.
Retrieves a list of comments for a file.
Get a list of file versions on legal hold for a legal hold assignment. due to ongoing re-architecture efforts this api might not return all file versions for this policy id. inst…
Retrieves all file version retentions for the given enterprise. **note**: file retention api is now **deprecated**. to get information about files and file versions under retenti…
**this is a beta feature, which means that its availability might be limited.** returns all app items the folder is associated with. this includes app items associated with ances…
Retrieves a list of pending and active collaborations for a folder. this returns all the users that have access to the folder or have been invited to the folder.
Retrieves folder lock details for a given folder. you must be authenticated as the owner or co-owner of the folder to use this endpoint.
Retrieves all the collaborations for a group. the user must have admin permissions to inspect enterprise's groups. each collaboration object has details on which files or folders…
Retrieves all of the groups for a given enterprise. the user must have admin permissions to inspect enterprise's groups.
Retrieves a page of items in a folder. these items can be files, folders, and web links. to request more information about the folder itself, like its size, use the [get a folder…
Retrieves a list of items a legal hold policy has been assigned to.
Retrieves all the members for a group. only members of this group or users with admin-level permissions will be able to use this api.
Retrieves a list of all the metadata cascade policies that are applied to a given folder. this can not be used on the root folder with id `0`.
Retrieves all metadata for a given file.
Retrieves all metadata for a given folder. this can not be used on the root folder with id `0`.
Return a list of the chunks uploaded to the upload session so far. the actual endpoint url is returned by the [`create upload session`](e://post-files-upload-sessions) and [`get …
Retrieves all pending collaboration invites for this user.
List previous file versions for legal hold policy assignment
Returns information about the recent items accessed by a user, either in the last 90 days or up to the last 1000 items accessed.
Retrieves all of the retention policies for an enterprise.
Returns a list of all retention policy assignments associated with a specified retention policy.
Lists shield information barrier reports.
Retrieves a list of shield information barrier objects for the enterprise of jwt.
Lists shield information barrier segment members based on provided segment ids.
Lists shield information barrier segment restrictions based on provided segment id.
Retrieves a list of shield information barrier segment objects for the specified information barrier id.
Lists [slack integration mappings](https://support.box.com/hc/en-us/articles/4415585987859-box-as-the-content-layer-for-slack) in a users' enterprise. you need admin or co-admin …
Fetches all the storage policies in the enterprise.
Fetches all the storage policy assignment for an enterprise or user.
Lists all of the assignments for a given task.
Retrieves a list of all the tasks for a file. this endpoint does not support pagination.
Lists [teams integration mappings](https://support.box.com/hc/en-us/articles/360044681474-using-box-for-teams) in a users' enterprise. you need admin or co-admin role to use this…
Returns the current terms of service text and settings for the enterprise.
Retrieves an overview of users and their status for a terms of service, including whether they have accepted the terms and when.
Retrieves the files and folders that have been moved to the trash. any attribute in the full files or folders objects can be passed in with the `fields` parameter to retrieve tho…
Returns up to a year of past events for a given user or for the entire enterprise. by default this returns events for the authenticated user. to retrieve events for the entire en…
Retrieves all email aliases for a user. the collection does not include the primary login for the user.
Returns a list of users who have been exempt from the collaboration domain restrictions.
Retrieves all the groups for a user. only members of this group or users with admin-level permissions will be able to use this api.
Returns list of workflows that act on a given `folder id`, and have a flow with a trigger type of `workflow manual start`. you application must be authorized to use the `manage b…
Permanently deletes a file that is in the trash. this action cannot be undone.
Permanently deletes a folder that is in the trash. this action cannot be undone.
Permanently deletes a web link that is in the trash. this action cannot be undone.
Performs a check to verify that a file will be accepted by box before you upload the entire file.
Promote a specific version of a file. if previous versions exist, this method can be used to promote one of the older versions to the top of the version history. this creates a n…
Create a search using sql-like syntax to return items that match specific metadata. by default, this endpoint returns only the most basic info about the items for which the query…
Refresh an access token using its client id, secret, and refresh token.
Removes any box skills cards metadata from a file.
Removes any classifications from a file. this api can also be called by including the enterprise id in the url explicitly, for example `/files/:id//enterprise 12345/securityclass…
Removes any classifications from a folder. this api can also be called by including the enterprise id in the url explicitly, for example `/folders/:id/enterprise 12345/securitycl…
Deletes a single collaboration.
Permanently deletes a comment.
Deletes an individual device pin.
Removes a domain from the list of domains that have been deemed safe to create collaborations for within the current enterprise.
Removes an email alias from a user.
Move a file version to the trash. versions are only tracked for box users with premium accounts.
Permanently deletes a group. only users with admin-level permissions will be able to use this api.
Delete an existing legal hold policy. this is an asynchronous process. the policy will not be fully deleted yet when the response returns.
Deletes a metadata cascade policy.
Deletes a piece of file metadata.
Deletes a piece of folder metadata.
Delete a metadata template and its instances. this deletion is permanent and can not be reversed.
Removes a retention policy assignment applied to content.
Removes a shared link from a file.
Removes a shared link from a folder.
Removes a shared link from a web link.
Removes a task from a file.
Abort an upload session and discard all data uploaded. this cannot be reversed. the actual endpoint url is returned by the [`create upload session`](e://post-files-upload-session…
Removes a user's exemption from the restrictions set out by the allowed list of domains for collaborations.
Deletes a specific group membership. only admins of this group or users with admin-level permissions will be able to use this api.
Removes the watermark from a file.
Removes the watermark from a folder.
Deletes a webhook.
Deletes a web link.
Request an access token using either a client-side obtained oauth 2.0 authorization code or a server-side jwt assertion. an access token is a string that enables box to verify th…
Resends a signature request email to all outstanding signers.
Restores a file that has been moved to the trash. an optional new parent id can be provided to restore the file to in case the original folder has been deleted.
Restores a specific version of a file after it was deleted. don't use this endpoint to restore box notes, as it works with file formats such as pdf, doc, pptx or similar.
Restores a folder that has been moved to the trash. an optional new parent id can be provided to restore the folder to in case the original folder has been deleted. during this o…
Restores a web link that has been moved to the trash. an optional new parent id can be provided to restore the web link to in case the original folder has been deleted.
Get a list of files with current file versions for a legal hold assignment. in some cases you may want to get previous file versions instead. in these cases, use the `get /legal …
Revoke an active access token, effectively logging a user out that has been previously authenticated.
Searches for files, folders, web links, and shared files across the users content or across the entire enterprise.
Initiates a flow with a trigger type of `workflow manual start`. you application must be authorized to use the `manage box relay` application scope within the developer console.
Transfers ownership of a specific folder (with id 0) from one user to another in the box cloud storage system. this endpoint should be used when you need to change the owner of a…
Remove a legal hold from an item. this is an asynchronous process. the policy will not be fully removed yet when the response returns.
Delete a storage policy assignment. deleting a storage policy assignment on a user will have the user inherit the enterprise's default storage policy. there is a rate limit for c…
Deletes a specific task assignment.
Updates an ai agent.
An alternative method that can be used to overwrite and update all box skill metadata cards on a file.
Updates a collaboration. can be used to change the owner of an item, or to accept collaboration invites.
Update the message of a comment.
Updates a file. this can be used to rename or move a file, create a shared link, or lock a file.
Updates a file request. this can be used to activate or deactivate a file request.
Updates a folder. this can be also be used to move the folder, create shared links, update collaborations, and more.
Updates a specific group. only admins of this group or users with admin-level permissions will be able to use this api.
Updates a user's group membership. only admins of this group or users with admin-level permissions will be able to use this api.
Update legal hold policy.
Updates a retention policy.
Updates a shared link on a file.
Updates a shared link on a folder.
Updates a shared link on a web link.
Update shield information barrier segment with specified id
Updates a [slack integration mapping](https://support.box.com/hc/en-us/articles/4415585987859-box-as-the-content-layer-for-slack). supports updating the box folder id and options…
Updates a specific storage policy assignment.
Updates a task. this can be used to update a task's configuration, or to update its completion state.
Updates a task assignment. this endpoint can be used to update the state of a task assigned to a user.
Updates a [teams integration mapping](https://support.box.com/hc/en-us/articles/360044681474-using-box-for-teams). supports updating the box folder id and options. you need admin…
Updates a specific terms of service.
Updates the status for a terms of service for a user.
Updates a managed or app user in an enterprise. this endpoint is only available to users and applications with the right admin permissions.
Updates a webhook.
Updates a web link object.
Uploads a small file to box. for file sizes over 50mb we recommend using the chunk upload apis. the `attributes` part of the body must come **before** the `file` part. requests t…
Update a file's content. for file sizes over 50mb we recommend using the chunk upload apis. the `attributes` part of the body must come **before** the `file` part. requests that …
Uploads a chunk of a file for an upload session. the actual endpoint url is returned by the [`create upload session`](e://post-files-upload-sessions) and [`get upload session`](e…
Curated for Box's real category — not Pipedream's auto-tagged bucket.
Explore AI-powered workflows that work with Box.
