API Reference

Resources

OAuth 2.0 error Access token

Endpoints

GETAuthorize user POSTRequest access token POSTRefresh access token POSTRevoke access token

Classifications

Resources

Classification Classification Template

Endpoints

GETList all classifications POSTAdd initial classifications PUTAdd classification PUTUpdate classification PUTDelete classification DELDelete all classifications

Classifications on files

Endpoints

GETGet classification on file POSTAdd classification to file PUTUpdate classification on file DELRemove classification from file

Classifications on folders

Endpoints

GETGet classification on folder POSTAdd classification to folder PUTUpdate classification on folder DELRemove classification from folder

Resources

Collaboration Collaborations

Endpoints

GETGet collaboration POSTCreate collaboration PUTUpdate collaboration DELRemove collaboration

Collaborations (List)

Endpoints

GETList file collaborations GETList folder collaborations GETList pending collaborations GETList group collaborations

Resources

Collection Collections

Endpoints

GETList all collections GETList collection items

Resources

Comment Comments Comment (Base)Comment (Full)

Endpoints

GETList file comments GETGet comment POSTCreate comment PUTUpdate comment DELRemove comment

Resources

Device pinner Device pinners

Endpoints

GETGet device pin GETList enterprise device pins DELRemove device pin

Domain restrictions (User exemptions)

Resources

Allowed collaboration domains user exemption Allowed collaboration domains user exemptions

Endpoints

GETList users exempt from collaboration domain restrictions GETGet user exempt from collaboration domain restrictions POSTCreate user exemption from collaboration domain restrictions DELRemove user from list of users exempt from domain restrictions

Domain restrictions for collaborations

Resources

Allowed collaboration domain Allowed collaboration domains

Endpoints

GETList allowed collaboration domains GETGet allowed collaboration domain POSTAdd domain to list of allowed collaboration domains DELRemove domain from list of allowed collaboration domains

Endpoints

GETDownload file

Resources

Email alias Email aliases

Endpoints

GETList user's email aliases POSTCreate email alias DELRemove email alias

Resources

Event Events Real-time servers

Endpoints

GETList user and enterprise events OPTSGet events long poll endpoint

Resources

Endpoints

GETGet file request POSTCopy file request PUTUpdate file request DELDelete file request

File version legal holds

Resources

File version legal hold File version legal holds

Endpoints

GETGet file version legal hold GETList file version legal holds

File version retentions

Resources

File version retention File version retentions

Endpoints

GETList file version retentions GETGet retention on file

Resources

Endpoints

GETList all file versions GETGet file version POSTPromote file version PUTRestore file version DELRemove file version

Resources

File Files File (Full)File (Mini)File (Base)

Endpoints

GETGet file information GETGet file thumbnail POSTCopy file PUTUpdate file DELDelete file

Resources

Folder Lock Folder Locks

Endpoints

GETList folder locks POSTCreate folder lock DELDelete folder lock

Resources

Folder Folder (Full)Folder (Mini)Folder (Base)Items

Endpoints

GETGet folder information GETList items in folder POSTCreate folder POSTCopy folder PUTUpdate folder DELDelete folder

Group memberships

Resources

Group membership Group memberships

Endpoints

GETList user's groups GETList members of group GETGet group membership POSTAdd user to group PUTUpdate group membership DELRemove user from group

Resources

Group Groups Group (Base)Group (Full)Group (Mini)

Endpoints

GETList groups for enterprise GETGet group POSTCreate group PUTUpdate group DELRemove group

Integration mappings

Resources

Integration mapping Integration mapping (Base)Integration mapping (Mini)Integration mappings

Endpoints

GETList Slack integration mappings POSTCreate Slack integration mapping PUTUpdate Slack integration mapping DELDelete Slack integration mapping

Resources

Endpoints

GETGet user invite status POSTCreate user invite

Legal hold policies

Resources

Legal hold policy Legal hold policies Legal hold policy (Mini)

Endpoints

GETList all legal hold policies GETGet legal hold policy POSTCreate legal hold policy PUTUpdate legal hold policy DELRemove legal hold policy

Legal hold policy assignments

Resources

Legal hold policy assignment Legal hold policy assignment (Base)Legal hold policy assignments

Endpoints

GETList legal hold policy assignments GETGet legal hold policy assignment GETList current file versions for legal hold policy assignment GETList previous file versions for legal hold policy assignment POSTAssign legal hold policy DELUnassign legal hold policy

Metadata cascade policies

Resources

Metadata cascade policy Metadata cascade policies

Endpoints

GETList metadata cascade policies GETGet metadata cascade policy POSTCreate metadata cascade policy POSTForce-apply metadata cascade policy to folder DELRemove metadata cascade policy

Metadata instances (Files)

Resources

Metadata instance Metadata instance (Full)Metadata instance (Base)Metadata instances

Endpoints

GETList metadata instances on file GETGet metadata instance on file POSTCreate metadata instance on file PUTUpdate metadata instance on file DELRemove metadata instance from file

Metadata instances (Folders)

Endpoints

GETList metadata instances on folder GETGet metadata instance on folder POSTCreate metadata instance on folder PUTUpdate metadata instance on folder DELRemove metadata instance from folder

Metadata templates

Resources

Metadata template Metadata templates

Endpoints

GETFind metadata template by instance ID GETGet metadata template by name GETGet metadata template by ID GETList all global metadata templates GETList all metadata templates for enterprise POSTCreate metadata template PUTUpdate metadata template DELRemove metadata template

Resources

Endpoints

GETList recently accessed items

Retention policies

Resources

Retention policies Retention policy Retention policy (Mini)Retention policy (Base)

Endpoints

GETList retention policies GETGet retention policy POSTCreate retention policy PUTUpdate retention policy DELDelete retention policy

Retention policy assignments

Resources

Files under retention Retention policy assignment (Base)Retention policy assignment Retention policy assignments

Endpoints

GETList retention policy assignments GETGet retention policy assignment GETGet files under retention GETGet file versions under retention POSTAssign retention policy DELRemove retention policy assignment

Resources

Metadata query index Metadata query indices Metadata query search results Search Results Search Results (including Shared Links)Search Result (including Shared Link)Metadata filter

Endpoints

GETList metadata query indices GETSearch for content POSTQuery files/folders by metadata

Session termination

Resources

Session termination message

Endpoints

POSTCreate jobs to terminate users session POSTCreate jobs to terminate user group session

Shared links (Files)

Endpoints

GETFind file for shared link GETGet shared link for file PUTAdd shared link to file PUTUpdate shared link on file PUTRemove shared link from file

Shared links (Folders)

Endpoints

GETFind folder for shared link GETGet shared link for folder PUTAdd shared link to folder PUTUpdate shared link on folder PUTRemove shared link from folder

Shared links (Web Links)

Endpoints

GETFind web link for shared link GETGet shared link for web link PUTAdd shared link to web link PUTUpdate shared link on web link PUTRemove shared link from web link

Shield information barrier reports

Resources

Shield information barrier report Shield information barrier report (Base)Shield information barrier reference Shield information barrier report details

Endpoints

GETList shield information barrier reports GETGet shield information barrier report by ID POSTCreate shield information barrier report

Shield information barrier segment members

Resources

Shield information barrier segment member Shield information barrier segment member (Base)Shield information barrier segment member (Mini)

Endpoints

GETGet shield information barrier segment member by ID GETList shield information barrier segment members POSTCreate shield information barrier segment member DELDelete shield information barrier segment member by ID

Shield information barrier segment restrictions

Resources

Shield information barrier segment restriction Shield information barrier segment restriction (Base)Shield information barrier segment restriction (Mini)

Endpoints

GETGet shield information barrier segment restriction by ID GETList shield information barrier segment restrictions POSTCreate shield information barrier segment restriction DELDelete shield information barrier segment restriction by ID

Shield information barrier segments

Resources

Shield information barrier segment

Endpoints

GETGet shield information barrier segment with specified ID GETList shield information barrier segments POSTCreate shield information barrier segment PUTUpdate shield information barrier segment with specified ID DELDelete shield information barrier segment

Shield information barriers

Resources

Shield information barrier Shield information barrier (Base)

Endpoints

GETGet shield information barrier with specified ID GETList shield information barriers POSTAdd changed status of shield information barrier with specified ID POSTCreate shield information barrier

Resources

Sign Request Sign Requests Sign Request (Base)

Endpoints

GETGet sign request by ID GETList sign requests POSTCancel sign request POSTResend sign request POSTCreate sign request

Resources

Box Sign template Box Sign templates

Endpoints

GETList Box Sign templates GETGet Box Sign template by ID

Resources

Skill webhook payload Skills metadata instance Keyword Skill Card Timeline Skill Card Transcript Skill Card Status Skill Card

Endpoints

GETList Box Skill cards on file POSTCreate Box Skill cards on file PUTUpdate Box Skill cards on file PUTUpdate all Box Skill cards on file DELRemove Box Skill cards from file

Standard and Zones Storage Policies

Resources

Storage policy Storage policies Storage policy (Mini)

Endpoints

GETList storage policies GETGet storage policy

Standard and Zones Storage Policy Assignments

Resources

Storage policy assignment Storage policy assignments

Endpoints

GETList storage policy assignments GETGet storage policy assignment POSTAssign storage policy PUTUpdate storage policy assignment DELUnassign storage policy

Task assignments

Resources

Task assignment Task assignments

Endpoints

GETList task assignments GETGet task assignment POSTAssign task PUTUpdate task assignment DELUnassign task

Resources

Endpoints

GETList tasks on file GETGet task POSTCreate task PUTUpdate task DELRemove task

Terms of service

Resources

Terms of service Terms of services Terms of service (Base)

Endpoints

GETList terms of services GETGet terms of service POSTCreate terms of service PUTUpdate terms of service

Terms of service user statuses

Resources

Terms of service user status Terms of service user statuses

Endpoints

GETList terms of service user statuses POSTCreate terms of service status for new user PUTUpdate terms of service status for existing user

Transfer folders

Endpoints

PUTTransfer owned folders

Resources

Trashed File Trashed File (Restored)

Endpoints

GETGet trashed file POSTRestore file DELPermanently remove file

Trashed folders

Resources

Trashed Folder Trashed Folder (Restored)

Endpoints

GETGet trashed folder POSTRestore folder DELPermanently remove folder

Endpoints

GETList trashed items

Trashed web links

Resources

Trashed Web Link Trashed Web Link (Restored)

Endpoints

GETGet trashed web link POSTRestore web link DELPermanently remove web link

Resources

Conflict error Upload URL

Endpoints

OPTSPreflight check before upload POSTUpload file version POSTUpload file

Uploads (Chunked)

Resources

Upload part Upload part (Mini)Uploaded part Upload parts Upload session

Endpoints

GETGet upload session GETList parts POSTCreate upload session POSTCreate upload session for existing file POSTCommit upload session PUTUpload part of file DELRemove upload session

Resources

Endpoints

GETGet user avatar POSTAdd or update user avatar DELDelete user avatar

Resources

User Users User (Full)User (Mini)User (Base)User (Collaborations)User (Integration Mappings)

Endpoints

GETList enterprise users GETGet current user GETGet user POSTCreate user PUTUpdate user DELDelete user

Watermarks (Files)

Resources

Endpoints

GETGet watermark on file PUTApply watermark to file DELRemove watermark from file

Watermarks (Folders)

Endpoints

GETGet watermark for folder PUTApply watermark to folder DELRemove watermark from folder

Resources

Web link Web link (Base)Web link (Mini)

Endpoints

GETGet web link POSTCreate web link PUTUpdate web link DELRemove web link

Resources

Webhook (V2) payload Webhook Webhook (Mini)Webhooks

Endpoints

GETList all webhooks GETGet webhook POSTCreate webhook PUTUpdate webhook DELRemove webhook

Resources

Workflow Workflow (Full)Workflow (Mini)Workflows

Endpoints

GETList workflows POSTStarts workflow based on request body

Resources

Zip download Zip download status

Endpoints

GETDownload zip archive GETGet zip download status POSTCreate zip download

Access token Classification Classification Template Client error Collaboration Allowed collaboration domains Allowed collaboration domain Allowed collaboration domains user exemption Allowed collaboration domains user exemptions Collaborations

Collection Collections Comment Comment (Base)Comment (Full)Comments Conflict error Device pinner Device pinners Email alias

Email aliases Enterprise (Base)Event Event source Events File File (Base)File (Full)File (Mini)File (Conflict)

File Request File version File version (Base)File version (Full)File version (Mini)File version legal hold File version legal holds File version retention File version retentions File versions

Files Files under retention Folder Folder (Base)Folder (Full)Folder (Mini)Folder Lock Folder Locks Group Group (Base)

Group (Full)Group (Mini)Group membership Group memberships Groups Integration mapping Integration mapping (Base)Integration mapping (Mini)Create integration mapping request Integration mappings

Invite Items Keyword Skill Card Legal hold policies Legal hold policy Legal hold policy (Mini)Legal hold policy assignment Legal hold policy assignment (Base)Legal hold policy assignments Metadata instance

Metadata instance (Base)Metadata instance (Full)Metadata cascade policies Metadata cascade policy Metadata field filter (date range)Metadata field filter (float)Metadata field filter (float range)Metadata field filter (multi-select)Metadata field filter (string)Metadata filter

Metadata query index Metadata query indices Metadata query search results Metadata template Metadata templates Metadata instances OAuth 2.0 error Real-time server Real-time servers Recent item

Recent items Retention policies Retention policy Retention policy (Base)Retention policy (Mini)Retention policy assignment Retention policy assignment (Base)Retention policy assignments Search Result (including Shared Link)Search Results

Search Results (including Shared Links)Session termination message Shield information barrier Shield information barrier (Base)Shield information barrier reference Shield information barrier report Shield information barrier report (Base)Shield information barrier report details Shield information barrier segment Shield information barrier segment member

Shield information barrier segment member (Base)Shield information barrier segment member (Mini)Shield information barrier segment restriction Shield information barrier segment restriction (Base)Shield information barrier segment restriction (Mini)Sign Request Sign Request (Base)Sign Requests Box Sign template Box Sign templates

Skills metadata instance Skill webhook payload Status Skill Card Storage policies Storage policy Storage policy (Mini)Storage policy assignment Storage policy assignments Task Task assignment

Task assignments Tasks Terms of service Terms of service (Base)Terms of service user status Terms of services Terms of service user statuses Timeline Skill Card Transcript Skill Card Trashed File

Trashed File (Restored)Trashed Folder Trashed Folder (Restored)Trashed Web Link Trashed Web Link (Restored)Upload part Upload part (Mini)Upload parts Upload session Upload URL

Uploaded part User User (Base)User (Full)User (Mini)User avatar User (Collaborations)User (Integration Mappings)Users Watermark

Web link Web link (Base)Web link (Mini)Webhook Webhook (Mini)Webhook (V2) payload Webhooks Workflow Workflow (Full)Workflow (Mini)

Workflows Zip download Zip download status