Box
Cloud content management and file sharing service for businesses.
Create metadata instance on file
Create metadata instance on file
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
template which accepts any key-value pair.
Create metadata cascade policy
Create metadata cascade 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 the policy to be applied a metadata instance must first be applied to the folder the policy is to be applied to.
Commit upload session
Commit upload session
Close an upload session and create a file from the uploaded chunks. the actual endpoint url is returned by the create upload session
and get upload session
endpoints.
Create slack integration mapping
Create slack integration mapping
Creates a slack integration mapping by mapping a slack channel to a box item. you need admin or co-admin role to use this endpoint.
Create comment
Create comment
Adds a comment by the user to a specific file, or as a reply to an other comment.
Create metadata instance on folder
Create metadata instance on folder
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
template which accepts any key-value pair. to display the metadata template in the box web app the enterprise needs to be configured to enable cascading folder level metadata for the user in the admin console.
Create collaboration
Create collaboration
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 being created with a group, access to this endpoint is dependent on the group’s ability to be invited. if collaboration is in pending
status, the following fields are redacted: - login
and name
are hidden if a collaboration was created using user id
, - name
is hidden if a collaboration was created using login
.
Ask question
Ask question
Sends an ai request to supported llms and returns an answer specifically focused on the user’s question given the provided context.
Add domain to list of allowed collaboration domains
Add domain to list of allowed collaboration domains
Creates a new entry in the list of allowed domains to allow collaboration for.
Create retention policy
Create retention policy
Creates a retention policy.
Create task
Create task
Creates a single task on a file. this task is not assigned to any user and will need to be assigned separately.
Create teams integration mapping
Create teams integration mapping
Creates a teams integration mapping by mapping a teams channel to a box item. you need admin or co-admin role to use this endpoint.
Create user
Create user
Creates a new managed user in an enterprise. this endpoint is only available to users and applications with the right admin permissions.
Delete ai agent
Delete ai agent
Deletes an ai agent using the provided parameters.
Create shield information barrier
Create shield information barrier
Creates a shield information barrier to separate individuals/groups within the same firm and prevents confidential information passing between them.
Delete folder
Delete folder
Deletes a folder, either permanently or by moving it to the trash.
Create shield information barrier segment
Create shield information barrier segment
Creates a shield information barrier segment.
Create email alias
Create email alias
Adds a new email alias to a user account..
Delete file
Delete file
Deletes a file, either permanently or by moving it to the trash. the enterprise settings determine whether the item will be permanently deleted from box or moved to the trash.
Create terms of service
Create terms of service
Creates a terms of service for a given enterprise and type of user.
Delete file request
Delete file request
Deletes a file request permanently.
Create user exemption from collaboration domain restrictions
Create user exemption from collaboration domain restrictions
Exempts a user from the restrictions set out by the allowed list of domains for collaborations.
Create shield information barrier report
Create shield information barrier report
Creates a shield information barrier report for a given barrier.
Create folder
Create folder
Creates a new empty folder within the specified parent folder.
Delete folder lock
Delete folder lock
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.
Create user invite
Create user invite
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 receive an email and are prompted to accept the invitation within the box web application. this method requires the “manage an enterprise” scope enabled for the application, which can be enabled within the developer console.
Delete retention policy
Delete retention policy
Permanently deletes a retention policy.
Delete shield information barrier segment member by id
Delete shield information barrier segment member by id
Deletes a shield information barrier segment member based on provided id.
Create folder lock
Create folder lock
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.
Create upload session
Create upload session
Creates an upload session for a new file.
Delete shield information barrier segment restriction by id
Delete shield information barrier segment restriction by id
Delete shield information barrier segment restriction based on provided id.
Create terms of service status for new user
Create terms of service status for new user
Sets the status for a terms of service for a user.
Delete shield information barrier segment
Delete shield information barrier segment
Deletes the shield information barrier segment based on provided id.
Create group
Create group
Creates a new group of users in an enterprise. only users with admin permissions can create new groups.
Copy file
Copy file
Creates a copy of a file.
Delete slack integration mapping
Delete slack integration mapping
Deletes a slack integration mapping. you need admin or co-admin role to use this endpoint.
Create webhook
Create webhook
Creates a webhook.
Delete user avatar
Delete user avatar
Removes an existing user avatar. you cannot reverse this operation.
Create upload session for existing file
Create upload session for existing file
Creates an upload session for an existing file.
Download zip archive
Download zip archive
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 user’s device. by default, this url is only valid for a few seconds from the creation of the request for this archive. once a download has started it can not be stopped and resumed, instead a new request for a zip archive would need to be created. the url of this endpoint should not be considered as fixed. instead, use the [create zip download](e://post zip downloads) api to request to create a zip
archive, and then follow the download url
field in the response to this endpoint.
Delete teams integration mapping
Delete teams integration mapping
Deletes a teams integration mapping. you need admin or co-admin role to use this endpoint.
Download file
Download file
Returns the contents of a file in binary format.
Delete user
Delete user
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 their files.
Find app item for shared link
Find app item for shared link
Create jobs to terminate users session
Create jobs to terminate users session
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.
Extract metadata structured
Extract metadata structured
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 a list of fields you want to extract. input is either a metadata template or a list of fields to ensure the structure. to learn more about creating templates, see creating metadata templates in the admin console or use the metadata template api.
Find web link for shared link
Find web link for shared link
Create jobs to terminate user group session
Create jobs to terminate user group session
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.
Force apply metadata cascade policy to folder
Force apply metadata cascade policy to folder
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 to be cascaded down to all existing files within that folder.
Create legal hold policy
Create legal hold policy
Create a new legal hold policy.
Create metadata template
Create metadata template
Creates a new metadata template that can be applied to files and folders.
Create web link
Create web link
Creates a web link object within a folder.
Find metadata template by instance id
Find metadata template by instance id
Finds a metadata template by searching for the id of an instance of the template.
Find folder for shared link
Find folder for shared link
Create zip download
Create zip download
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 the user has access to all the items, and then returns a download url
and a status url
that can be used to download the archive. the limit for an archive is either the account’s upload limit or 10,000 files, whichever is met first. note: downloading a large file can be affected by various factors such as distance, network latency, bandwidth, and congestion, as well as packet loss ratio and current server load. for these reasons we recommend that a maximum zip archive total size does not exceed 25gb.
Extract metadata freeform
Extract metadata freeform
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. metadata template setup before sending the request is not required.
Find file for shared link
Find file for shared link
Copy file request
Copy file request
Copies an existing file request that is already present on one folder, and applies it to another folder.
Assign legal hold policy
Assign legal hold policy
Assign a legal hold to a file, file version, folder, or user.
Generate text
Generate text
Sends an ai request to supported large language models (llms) and returns generated text based on the provided prompt.
Copy folder
Copy folder
Creates a copy of a folder within a destination folder. the original folder will not be changed.
Assign retention policy
Assign retention policy
Assigns a retention policy to an item.
Assign storage policy
Assign storage policy
Creates a storage policy assignment for an enterprise or user.
Create shield information barrier segment member
Create shield information barrier segment member
Creates a new shield information barrier segment member.
Add or update user avatar
Add or update user avatar
Adds or updates a user avatar.
Add classification to folder
Add classification to folder
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 example /folders/:id/enterprise 12345/securityclassification-6vmvochwuwo
.
Add classification to file
Add classification to file
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 example /files/:id//enterprise 12345/securityclassification-6vmvochwuwo
.
Add initial classifications
Add initial classifications
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 has a classification, the template will already exist and instead an api call should be made to add additional classifications.
Assign task
Assign task
Assigns a task to a user. a task can be assigned to more than one user by creating multiple assignments.
Authorize user
Authorize user
Cancel box sign request
Cancel box sign request
Cancels a sign request.
Add shared link to file
Add shared link to file
Create ai agent
Create ai agent
Creates an ai agent. at least one of the following capabilities must be provided: ask
, text gen
, extract
.
Create box skill cards on file
Create box skill cards on file
Applies one or more box skills metadata cards to a file.
Add shared link to folder
Add shared link to folder
Change shield information barrier status
Change shield information barrier status
Change status of shield information barrier with the specified id.
Create box sign request
Create box sign request
Creates a signature request. this involves preparing a document for signing and sending the signature request to signers.
Add shared link to web link
Add shared link to web link
Create shield information barrier segment restriction
Create shield information barrier segment restriction
Creates a shield information barrier segment restriction object.
Apply watermark to folder
Apply watermark to folder
Applies or update a watermark on a folder.
Apply watermark to file
Apply watermark to file
Applies or update a watermark on a file.
Get ai agent by agent id
Get ai agent by agent id
Gets an ai agent using the agent id
parameter.
Add user to group
Add user to group
Creates a group membership. only users with admin-level permissions will be able to use this api.
Get ai agent default configuration
Get ai agent default configuration
Get the ai agent default config
Get box sign template by id
Get box sign template by id
Fetches details of a specific box sign template.
Get trashed file
Get trashed file
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 its parent folders was moved to the trash, only that folder can be inspected using the [get /folders/:id/trash
](e://get folders id trash) api. to list all items that have been moved to the trash, please use the get /folders/trash/items
api.
Get shield information barrier report by id
Get shield information barrier report by id
Retrieves a shield information barrier report by its id.
Get watermark for folder
Get watermark for folder
Retrieve the watermark for a folder.
Get shared link for web link
Get shared link for web link
Get classification on file
Get classification on file
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 /files/:id//enterprise 12345/securityclassification-6vmvochwuwo
.
Get terms of service
Get terms of service
Fetches a specific terms of service.
Get events long poll endpoint
Get events long poll endpoint
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 interacting with the /events endpoint. it’s particularly useful for understanding the types of events that can be monitored, the format of event data, and any constraints or limitations on event retrieval. this endpoint should be used when setting up event monitoring or webhook integrations to ensure proper configuration and understanding of the event system. while it doesn’t directly fetch events, it offers crucial metadata for effectively working with box’s event streaming and notification features.
Get collaboration
Get collaboration
Retrieves a single collaboration.
Get box sign request by id
Get box sign request by id
Gets a sign request by id.
Get classification on folder
Get classification on folder
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 /folders/:id/enterprise 12345/securityclassification-6vmvochwuwo
.
Get files under retention
Get files under retention
Returns a list of files under retention for a retention policy assignment.
Get user invite status
Get user invite status
Returns the status of a user invite.
Get allowed collaboration domain
Get allowed collaboration domain
Returns a domain that has been deemed safe to create collaborations for within the current enterprise.
Get watermark on file
Get watermark on file
Retrieve the watermark for a file.
Get metadata cascade policy
Get metadata cascade policy
Retrieve a specific metadata cascade policy assigned to a folder.
Get webhook
Get webhook
Retrieves a specific webhook
Get collection by id
Get collection by id
Retrieves a collection by its id.
List all file versions
List all file versions
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 /file/:id
api.
Get file information
Get file information
Retrieves the details about a file.
List file collaborations
List file collaborations
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.
List all global metadata templates
List all global metadata templates
Used to retrieve all generic, global metadata templates available to all enterprises using box.
List collection items
List collection items
Retrieves the files and/or folders contained within this collection.
Get current user
Get current user
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. in the case of a jwt, server-side authenticated application this will be the service account that belongs to the application by default. use the as-user
header to change who this api call is made on behalf of.
List box sign templates
List box sign templates
Gets box sign templates created by a user.
List file version legal holds
List file version legal holds
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. instead, this api will only return file versions held in the legacy architecture. two new endpoints will available to request any file versions held in the new architecture. for file versions held in the new architecture, the get /legal hold policy assignments/:id/file versions on hold
api can be used to return all past file versions available for this policy assignment, and the get /legal hold policy assignments/:id/files on hold
api can be used to return any current (latest) versions of a file under legal hold. the get /legal hold policy assignments?policy id=\{id\}
api can be used to find a list of policy assignments for a given policy id. once the re-architecture is completed this api will be deprecated.
List file comments
List file comments
Retrieves a list of comments for a file.
List box skill cards on file
List box skill cards on file
List the box skills metadata cards that are attached to a file.
Get comment
Get comment
Retrieves the message and metadata for a specific comment, as well as information on the user who created the comment.
List all collections
List all collections
Retrieves all collections for a given user. currently, only the favorites
collection is supported.
List all legal hold policies
List all legal hold policies
Retrieves a list of legal hold policies that belong to an enterprise.
Get metadata instance on file
Get metadata instance on file
Retrieves the instance of a metadata template that has been applied to a file.
Get metadata instance on folder
Get metadata instance on folder
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
.
List folder collaborations
List folder collaborations
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.
Get web link
Get web link
Retrieve information about a web link.
Get file request
Get file request
Retrieves the information about a file request.
List folder app item associations
List folder app item associations
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 ancestors of the folder. assuming the context user has access to the folder, the type/ids are revealed even if the context user does not have view permission on the app item.
List folder locks
List folder locks
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.
List groups for enterprise
List groups for enterprise
Retrieves all of the groups for a given enterprise. the user must have admin permissions to inspect enterprise’s groups.
List file version retentions
List file version retentions
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 retention, see files under retention or file versions under retention endpoints.
List metadata instances on file
List metadata instances on file
Retrieves all metadata for a given file.
List members of group
List members of group
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.
List group collaborations
List group collaborations
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 the group has access to and with what role.
List items in folder
List items in folder
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 endpoint instead.
List all metadata templates for enterprise
List all metadata templates for enterprise
Used to retrieve all metadata templates created to be used specifically within the user’s enterprise
Get device pin
Get device pin
Retrieves information about an individual device pin.
Get metadata template by id
Get metadata template by id
Retrieves a metadata template by its id.
Get trashed folder
Get trashed folder
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 of its parent folders was moved to the trash, only that folder can be inspected using the [get /folders/:id/trash
](e://get folders id trash) api. to list all items that have been moved to the trash, please use the get /folders/trash/items
api.
List legal hold policy assignments
List legal hold policy assignments
Retrieves a list of items a legal hold policy has been assigned to.
List metadata instances on folder
List metadata instances on folder
Retrieves all metadata for a given folder. this can not be used on the root folder with id 0
.
List all webhooks
List all webhooks
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 means that an admin can not see webhooks created by a service account unless the admin has access to those folders, and vice versa.
Get zip download status
Get zip download status
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 endpoint can only be accessed once the download has started. subsequently this endpoint is valid for 12 hours from the start of the download. the url of this endpoint should not be considered as fixed. instead, use the [create zip download](e://post zip downloads) api to request to create a zip
archive, and then follow the status url
field in the response to this endpoint.
Get file thumbnail
Get file thumbnail
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
, 160x160
, and 320x320
can be returned in the .jpg
format. thumbnails can be generated for the image and video file formats listed [found on our community site][1]. [1]: https://community.box.com/t5/migrating-and-previewing-content/file-types-and-fonts-supported-in-box-content-preview/ta-p/327
List parts
List parts
Return a list of the chunks uploaded to the upload session so far. the actual endpoint url is returned by the create upload session
and get upload session
endpoints.
List enterprise device pins
List enterprise device pins
Retrieves all the device pins within an enterprise. the user must have admin privileges, and the application needs the “manage enterprise” scope to make this call.
List previous file versions for legal hold policy assignment
List previous file versions for legal hold policy assignment
Get a list of previous file versions for a legal hold assignment. in some cases you may only need the latest file versions instead. in these cases, use the get /legal hold policy assignments/:id/files on hold
api instead to return any current (latest) versions of a file for this legal hold policy assignment. due to ongoing re-architecture efforts this api might not return all files held for this policy id. instead, this api will only return past file versions held in the newly developed architecture. the get /file version legal holds
api can be used to fetch current and past versions of files held within the legacy architecture. this endpoint does not support returning any content that is on hold due to a custodian collaborating on a hub. the get /legal hold policy assignments?policy id=\{id\}
api can be used to find a list of policy assignments for a given policy id.
List retention policy assignments
List retention policy assignments
Returns a list of all retention policy assignments associated with a specified retention policy.
List pending collaborations
List pending collaborations
Retrieves all pending collaboration invites for this user.
List metadata cascade policies
List metadata cascade policies
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
.
List shield information barriers
List shield information barriers
Retrieves a list of shield information barrier objects for the enterprise of jwt.
Get metadata template by name
Get metadata template by name
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 list all templates applied to a file or folder.
Get trashed web link
Get trashed web link
Retrieves a web link that has been moved to the trash.
List box sign requests
List box sign requests
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.
Get shield information barrier segment member by id
Get shield information barrier segment member by id
Retrieves a shield information barrier segment member by its id.
List recently accessed items
List recently accessed items
Returns information about the recent items accessed by a user, either in the last 90 days or up to the last 1000 items accessed.
List retention policies
List retention policies
Retrieves all of the retention policies for an enterprise.
Get retention on file
Get retention on file
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 files under retention or file versions under retention endpoints.
Get file version
Get file version
Retrieve a specific version of a file. versions are only tracked for box users with premium accounts.
List shield information barrier reports
List shield information barrier reports
Lists shield information barrier reports.
List shield information barrier segments
List shield information barrier segments
Retrieves a list of shield information barrier segment objects for the specified information barrier id.
List ai agents
List ai agents
Lists ai agents based on the provided parameters.
Get upload session
Get upload session
Return information about an upload session. the actual endpoint url is returned by the create upload session
endpoint.
Get storage policy
Get storage policy
Fetches a specific storage policy.
List shield information barrier segment restrictions
List shield information barrier segment restrictions
Lists shield information barrier segment restrictions based on provided segment id.
List shield information barrier segment members
List shield information barrier segment members
Lists shield information barrier segment members based on provided segment ids.
Get file versions under retention
Get file versions under retention
Returns a list of file versions under retention for a retention policy assignment.
Get shield information barrier with specified id
Get shield information barrier with specified id
Get shield information barrier based on provided id.
Get shield information barrier segment with specified id
Get shield information barrier segment with specified id
Retrieves shield information barrier segment based on provided id..
Get retention policy assignment
Get retention policy assignment
Retrieves a retention policy assignment
Get storage policy assignment
Get storage policy assignment
Fetches a specific storage policy assignment.
Get file version legal hold
Get file version legal hold
Retrieves information about the legal hold policies assigned to a file version.
Get user avatar
Get user avatar
Retrieves an image of a the user’s avatar.
Get shield information barrier segment restriction by id
Get shield information barrier segment restriction by id
Retrieves a shield information barrier segment restriction based on provided id.
Get retention policy
Get retention policy
Retrieves a retention policy.
Get user
Get user
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 endpoint also returns a limited set of information for external users who are collaborated on content owned by the enterprise for authenticated users with the right scopes. in this case, disallowed fields will return null instead.
List allowed collaboration domains
List allowed collaboration domains
Returns the list domains that have been deemed safe to create collaborations for within the current enterprise.
List enterprise users
List enterprise users
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 look up users in the entire enterprise.
Get task assignment
Get task assignment
Retrieves information about a task assignment.
Get group membership
Get group membership
Retrieves a specific group membership. only admins of this group or users with admin-level permissions will be able to use this api.
Get shared link for file
Get shared link for file
Get folder information
Get folder information
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 list of returned folder items. to fetch more items within the folder, use the get items in a folder endpoint.
Get user exempt from collaboration domain restrictions
Get user exempt from collaboration domain restrictions
Returns a users who has been exempt from the collaboration domain restrictions.
Get task
Get task
Retrieves information about a specific task.
List file app item associations
List file app item associations
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 ancestors of the file. assuming the context user has access to the file, the type/ids are revealed even if the context user does not have view permission on the app item.
Get group
Get group
Retrieves information about a group. only members of this group or users with admin-level permissions will be able to use this api.
List all classifications
List all classifications
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 url explicitly, for example /metadata templates/enterprise 12345/securityclassification-6vmvochwuwo/schema
.
Get legal hold policy
Get legal hold policy
Retrieve a legal hold policy.
Get legal hold policy assignment
Get legal hold policy assignment
Retrieve a legal hold policy assignment.
Get shared link for folder
Get shared link for folder
List storage policies
List storage policies
Fetches all the storage policies in the enterprise.
List user s email aliases
List user s email aliases
Retrieves all email aliases for a user. the collection does not include the primary login for the user.
List storage policy assignments
List storage policy assignments
Fetches all the storage policy assignment for an enterprise or user.
List trashed items
List trashed items
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 those specific attributes that are not returned by default. this endpoint defaults to use offset-based pagination, yet also supports marker-based pagination using the marker
parameter.
List terms of service user statuses
List terms of service user statuses
Retrieves an overview of users and their status for a terms of service, including whether they have accepted the terms and when.
List tasks on file
List tasks on file
Retrieves a list of all the tasks for a file. this endpoint does not support pagination.
Unassign legal hold policy
Unassign legal hold policy
Remove a legal hold from an item. this is an asynchronous process. the policy will not be fully removed yet when the response returns.
List task assignments
List task assignments
Lists all of the assignments for a given task.
Remove metadata instance from folder
Remove metadata instance from folder
Deletes a piece of folder metadata.
Remove collaboration
Remove collaboration
Deletes a single collaboration.
Remove watermark from file
Remove watermark from file
Removes the watermark from a file.
Remove user from list of users exempt from domain restrictions
Remove user from list of users exempt from domain restrictions
Removes a user’s exemption from the restrictions set out by the allowed list of domains for collaborations.
List user s groups
List user s groups
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.
List user and enterprise events
List user and enterprise events
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 enterprise, set the stream type
to admin logs streaming
for live monitoring of new events, or admin logs
for querying across historical events. the user making the api call will need to have admin privileges, and the application will need to have the scope manage enterprise properties
checked.
List teams integration mappings
List teams integration mappings
Lists teams integration mappings in a users’ enterprise. you need admin or co-admin role to use this endpoint.
List slack integration mappings
List slack integration mappings
Lists slack integration mappings in a users’ enterprise. you need admin or co-admin role to use this endpoint.
Remove classification from folder
Remove classification from folder
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/securityclassification-6vmvochwuwo
.
Remove watermark from folder
Remove watermark from folder
Removes the watermark from a folder.
Restore folder
Restore folder
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 operation, part of the file tree will be locked, mainly the source folder and all of its descendants, as well as the destination folder. for the duration of the operation, no other move, copy, delete, or restore operation can performed on any of the locked folders.
List terms of services
List terms of services
Returns the current terms of service text and settings for the enterprise.
Update file
Update file
Updates a file. this can be used to rename or move a file, create a shared link, or lock a file.
Update comment
Update comment
Update the message of a comment.
Update folder
Update folder
Updates a folder. this can be also be used to move the folder, create shared links, update collaborations, and more.
Update storage policy assignment
Update storage policy assignment
Updates a specific storage policy assignment.
Update legal hold policy
Update legal hold policy
Update legal hold policy.
Remove webhook
Remove webhook
Deletes a webhook.
Restore web link
Restore web link
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.
List workflows
List workflows
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 box relay
application scope within the developer console in to use this endpoint.
Unassign storage policy
Unassign storage policy
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 calling this endpoint of only twice per user in a 24 hour time frame.
Remove comment
Remove comment
Permanently deletes a comment.
Update group membership
Update group membership
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 file request
Update file request
Updates a file request. this can be used to activate or deactivate a file request.
Update group
Update group
Updates a specific group. only admins of this group or users with admin-level permissions will be able to use this api.
Update retention policy
Update retention policy
Updates a retention policy.
Permanently remove file
Permanently remove file
Permanently deletes a file that is in the trash. this action cannot be undone.
Remove device pin
Remove device pin
Deletes an individual device pin.
Update terms of service
Update terms of service
Updates a specific terms of service.
Unassign task
Unassign task
Deletes a specific task assignment.
Update slack integration mapping
Update slack integration mapping
Updates a slack integration mapping. supports updating the box folder id and options. you need admin or co-admin role to use this endpoint.
Update shared link on file
Update shared link on file
Permanently remove folder
Permanently remove folder
Permanently deletes a folder that is in the trash. this action cannot be undone.
Update task
Update task
Updates a task. this can be used to update a task’s configuration, or to update its completion state.
Update teams integration mapping
Update teams integration mapping
Updates a teams integration mapping. supports updating the box folder id and options. you need admin or co-admin role to use this endpoint.
Review files on legal hold policy assignment
Review files on legal hold policy assignment
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 hold policy assignments/:id/file versions on hold
api instead to return any previous versions of a file for this legal hold policy assignment. due to ongoing re-architecture efforts this api might not return all file versions held for this policy id. instead, this api will only return the latest file version held in the newly developed architecture. the get /file version legal holds
api can be used to fetch current and past versions of files held within the legacy architecture. this endpoint does not support returning any content that is on hold due to a custodian collaborating on a hub. the get /legal hold policy assignments?policy id=\{id\}
api can be used to find a list of policy assignments for a given policy id.
Update task assignment
Update task assignment
Updates a task assignment. this endpoint can be used to update the state of a task assigned to a user.
Remove web link
Remove web link
Deletes a web link.
Remove domain from list of allowed collaboration domains
Remove domain from list of allowed collaboration domains
Removes a domain from the list of domains that have been deemed safe to create collaborations for within the current enterprise.
Update ai agent
Update ai agent
Updates an ai agent.
Update webhook
Update webhook
Updates a webhook.
Update shared link on folder
Update shared link on folder
Update terms of service status for existing user
Update terms of service status for existing user
Updates the status for a terms of service for a user.
Upload file
Upload file
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 that do not follow this format when uploading the file will receive a http 400
error with a metadata after file contents
error code.
Update web link
Update web link
Updates a web link object.
Remove metadata template
Remove metadata template
Delete a metadata template and its instances. this deletion is permanent and can not be reversed.
Remove email alias
Remove email alias
Removes an email alias from a user.
Update user
Update user
Updates a managed or app user in an enterprise. this endpoint is only available to users and applications with the right admin permissions.
Permanently remove web link
Permanently remove web link
Permanently deletes a web link that is in the trash. this action cannot be undone.
Upload part of file
Upload part of file
Uploads a chunk of a file for an upload session. the actual endpoint url is returned by the create upload session
and get upload session
endpoints.
Remove file version
Remove file version
Move a file version to the trash. versions are only tracked for box users with premium accounts.
Remove retention policy assignment
Remove retention policy assignment
Removes a retention policy assignment applied to content.
Request access token
Request access token
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 that a request belongs to an authorized session. in the normal order of operations you will begin by requesting authentication from the authorize endpoint and box will send you an authorization code. you will then send this code to this endpoint to exchange it for an access token. the returned access token can then be used to make box api calls.
Preflight check before upload
Preflight check before upload
Performs a check to verify that a file will be accepted by box before you upload the entire file.
Upload file version
Upload file version
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 do not follow this format when uploading the file will receive a http 400
error with a metadata after file contents
error code.
Update shared link on web link
Update shared link on web link
Resend box sign request
Resend box sign request
Resends a signature request email to all outstanding signers.
Remove group
Remove group
Permanently deletes a group. only users with admin-level permissions will be able to use this api.
Remove shared link from folder
Remove shared link from folder
Restore file
Restore file
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.
Restore file version
Restore file version
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.
Update shield information barrier segment with specified id
Update shield information barrier segment with specified id
Updates the shield information barrier segment based on provided id..
Update all box skill cards on file
Update all box skill cards on file
An alternative method that can be used to overwrite and update all box skill metadata cards on a file.
Revoke access token
Revoke access token
Revoke an active access token, effectively logging a user out that has been previously authenticated.
List users exempt from collaboration domain restrictions
List users exempt from collaboration domain restrictions
Returns a list of users who have been exempt from the collaboration domain restrictions.
Remove shared link from file
Remove shared link from file
Promote file version
Promote file version
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 new copy of the old version and puts it at the top of the versions history. the file will have the exact same contents as the older version, with the same hash digest, etag
, and name as the original. other properties such as comments do not get updated to their former values. don’t use this endpoint to restore box notes, as it works with file formats such as pdf, doc, pptx or similar.
Remove shared link from web link
Remove shared link from web link
Remove task
Remove task
Removes a task from a file.
Remove metadata instance from file
Remove metadata instance from file
Deletes a piece of file metadata.
Update collaboration
Update collaboration
Updates a collaboration. can be used to change the owner of an item, or to accept collaboration invites.
Starts workflow based on request body
Starts workflow based on request body
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.
Refresh access token
Refresh access token
Refresh an access token using its client id, secret, and refresh token.
Remove legal hold policy
Remove legal hold policy
Delete an existing legal hold policy. this is an asynchronous process. the policy will not be fully deleted yet when the response returns.
Transfer owned folders
Transfer owned folders
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 user’s root folder, effectively transferring all of their content to another user. it’s particularly useful in scenarios such as employee offboarding or role transitions within an organization. the operation is irreversible, so it should be used with caution. note that this endpoint specifically targets the folder with id 0, which typically represents a user’s root folder in box.
Remove metadata cascade policy
Remove metadata cascade policy
Deletes a metadata cascade policy.
Remove classification from file
Remove classification from 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/securityclassification-6vmvochwuwo
.
Remove user from group
Remove user from group
Deletes a specific group membership. only admins of this group or users with admin-level permissions will be able to use this api.
Remove upload session
Remove upload session
Abort an upload session and discard all data uploaded. this cannot be reversed. the actual endpoint url is returned by the create upload session
and get upload session
endpoints.
Remove box skill cards from file
Remove box skill cards from file
Removes any box skills cards metadata from a file.
Search for content
Search for content
Searches for files, folders, web links, and shared files across the users content or across the entire enterprise.
Query files folders by metadata
Query files folders by metadata
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 matches. to get additional fields for each item, including any of the metadata, use the fields
attribute in the query.