• Additional Resources
  • Blog
Box Developer Documentation
Log in

API Reference

Authorization
Resources
OAuth 2.0 errorAccess token
Endpoints
GETAuthorize userPOSTRequest access tokenPOSTRefresh access tokenPOSTRevoke access token
Classifications
Resources
ClassificationClassification Template
Endpoints
GETList all classificationsPOSTAdd initial classificationsPUTAdd classificationPUTUpdate classificationPUTDelete classificationDELDelete all classifications
Classifications on files
Endpoints
GETGet classification on filePOSTAdd classification to filePUTUpdate classification on fileDELRemove classification from file
Classifications on folders
Endpoints
GETGet classification on folderPOSTAdd classification to folderPUTUpdate classification on folderDELRemove classification from folder
Collaborations
Resources
CollaborationCollaborations
Endpoints
GETGet collaborationPOSTCreate collaborationPUTUpdate collaborationDELRemove collaboration
Collaborations (List)
Endpoints
GETList file collaborationsGETList folder collaborationsGETList pending collaborationsGETList group collaborations
Collections
Resources
CollectionCollections
Endpoints
GETList all collectionsGETList collection items
Comments
Resources
CommentCommentsComment (Base)Comment (Full)
Endpoints
GETList file commentsGETGet commentPOSTCreate commentPUTUpdate commentDELRemove comment
Device pinners
Resources
Device pinnerDevice pinners
Endpoints
GETGet device pinGETList enterprise device pinsDELRemove device pin
Domain restrictions (User exemptions)
Resources
Allowed collaboration domains user exemptionAllowed collaboration domains user exemptions
Endpoints
GETGet user exempt from collaboration domain restrictionsGETList users exempt from collaboration domain restrictionsPOSTCreate user exemption from collaboration domain restrictionsDELRemove user from list of users exempt from domain restrictions
Domain restrictions for collaborations
Resources
Allowed collaboration domainAllowed collaboration domains
Endpoints
GETGet allowed collaboration domainGETList allowed collaboration domainsPOSTAdd domain to list of allowed collaboration domainsDELRemove domain from list of allowed collaboration domains
Downloads
Endpoints
GETDownload file
Email aliases
Resources
Email aliasEmail aliases
Endpoints
GETList user's email aliasesPOSTCreate email aliasDELRemove email alias
Events
Resources
Real-time serversEventEvents
Endpoints
GETList user and enterprise eventsOPTSGet events long poll endpoint
File requests
Resources
File Request
Endpoints
GETGet file requestPOSTCopy file requestPUTUpdate file requestDELDelete file request
File version legal holds
Resources
File version legal holdFile version legal holds
Endpoints
GETGet file version legal holdGETList file version legal holds
File version retentions
Resources
File version retentionFile version retentions
Endpoints
GETGet retention on fileGETList file version retentions
File versions
Resources
File versions
Endpoints
GETList all file versionsGETGet file versionPOSTPromote file versionPUTRestore file versionDELRemove file version
Files
Resources
FileFilesFile (Full)File (Mini)File (Base)
Endpoints
GETGet file informationGETGet file thumbnailPOSTCopy filePUTUpdate fileDELDelete file
Folder Locks
Resources
Folder LockFolder Locks
Endpoints
GETList folder locksPOSTCreate folder lockDELDelete folder lock
Folders
Resources
Folder (Mini)Folder (Base)FolderFolder (Full)Items
Endpoints
GETGet folder informationGETList items in folderPOSTCreate folderPOSTCopy folderPUTUpdate folderDELDelete folder
Group memberships
Resources
Group membershipGroup memberships
Endpoints
GETList user's groupsGETList members of groupGETGet group membershipPOSTAdd user to groupPUTUpdate group membershipDELRemove user from group
Groups
Resources
GroupGroupsGroup (Base)Group (Full)Group (Mini)
Endpoints
GETList groups for enterpriseGETGet groupPOSTCreate groupPUTUpdate groupDELRemove group
Integration mappings
Resources
Integration mappingIntegration mapping (Base)Integration mapping (Mini)Integration mappings
Endpoints
GETList Slack integration mappingsPOSTCreate Slack integration mappingPUTUpdate Slack integration mappingDELDelete Slack integration mapping
Invites
Resources
Invite
Endpoints
GETGet user invite statusPOSTCreate user invite
Legal hold policies
Resources
Legal hold policyLegal hold policy (Mini)Legal hold policies
Endpoints
GETGet legal hold policyGETList all legal hold policiesPOSTCreate legal hold policyPUTUpdate legal hold policyDELRemove legal hold policy
Legal hold policy assignments
Resources
Legal hold policy assignment (Base)Legal hold policy assignmentLegal hold policy assignments
Endpoints
GETGet legal hold policy assignmentGETList legal hold policy assignmentsGETList current file versions for legal hold policy assignmentGETList previous file versions for legal hold policy assignmentPOSTAssign legal hold policyDELUnassign legal hold policy
Metadata cascade policies
Resources
Metadata cascade policyMetadata cascade policies
Endpoints
GETGet metadata cascade policyGETList metadata cascade policiesPOSTForce-apply metadata cascade policy to folderPOSTCreate metadata cascade policyDELRemove metadata cascade policy
Metadata instances (Files)
Resources
Metadata instanceMetadata instance (Base)Metadata instancesMetadata instance (Full)
Endpoints
GETList metadata instances on fileGETGet metadata instance on filePOSTCreate metadata instance on filePUTUpdate metadata instance on fileDELRemove metadata instance from file
Metadata instances (Folders)
Endpoints
GETList metadata instances on folderGETGet metadata instance on folderPOSTCreate metadata instance on folderPUTUpdate metadata instance on folderDELRemove metadata instance from folder
Metadata templates
Resources
Metadata templateMetadata templates
Endpoints
GETGet metadata template by nameGETGet metadata template by IDGETFind metadata template by instance IDGETList all global metadata templatesGETList all metadata templates for enterprisePOSTCreate metadata templatePUTUpdate metadata templateDELRemove metadata template
Recent items
Resources
Recent item
Endpoints
GETList recently accessed items
Retention policies
Resources
Retention policiesRetention policyRetention policy (Mini)Retention policy (Base)
Endpoints
GETList retention policiesGETGet retention policyPOSTCreate retention policyPUTUpdate retention policyDELDelete retention policy
Retention policy assignments
Resources
Retention policy assignment (Base)Retention policy assignmentRetention policy assignmentsFiles under retention
Endpoints
GETList retention policy assignmentsGETGet retention policy assignmentGETGet files under retentionGETGet file versions under retentionPOSTAssign retention policyDELRemove retention policy assignment
Search
Resources
Metadata query indexMetadata query indicesMetadata filterMetadata query search resultsSearch ResultsSearch Results (including Shared Links)Search Result (including Shared Link)
Endpoints
GETList metadata query indicesGETSearch for contentPOSTQuery files/folders by metadata
Session termination
Resources
Session termination message
Endpoints
POSTCreate jobs to terminate users sessionPOSTCreate jobs to terminate user group session
Shared links (Files)
Endpoints
GETFind file for shared linkGETGet shared link for filePUTAdd shared link to filePUTUpdate shared link on filePUTRemove shared link from file
Shared links (Folders)
Endpoints
GETFind folder for shared linkGETGet shared link for folderPUTAdd shared link to folderPUTUpdate shared link on folderPUTRemove shared link from folder
Shared links (Web Links)
Endpoints
GETFind web link for shared linkGETGet shared link for web linkPUTAdd shared link to web linkPUTUpdate shared link on web linkPUTRemove shared link from web link
Shield information barrier reports
Resources
Shield information barrier reportShield information barrier report (Base)List of Shield Information Barrier ReportsShield information barrier referenceShield information barrier report details
Endpoints
GETList shield information barrier reportsGETGet shield information barrier report by IDPOSTCreate shield information barrier report
Shield information barrier segment members
Resources
Shield information barrier segment memberShield information barrier segment member (Base)Shield information barrier segment member (Mini)List of Shield Information Barrier Segment Members
Endpoints
GETGet shield information barrier segment member by IDGETList shield information barrier segment membersPOSTCreate shield information barrier segment memberDELDelete shield information barrier segment member by ID
Shield information barrier segment restrictions
Resources
Shield information barrier segment restrictionShield information barrier segment restriction (Base)Shield information barrier segment restriction (Mini)List of Shield Information Barrier Segment Restrictions
Endpoints
GETGet shield information barrier segment restriction by IDGETList shield information barrier segment restrictionsPOSTCreate shield information barrier segment restrictionDELDelete shield information barrier segment restriction by ID
Shield information barrier segments
Resources
Shield information barrier segmentList of Shield Information Barrier Segments
Endpoints
GETGet shield information barrier segment with specified IDGETList shield information barrier segmentsPOSTCreate shield information barrier segmentPUTUpdate shield information barrier segment with specified IDDELDelete shield information barrier segment
Shield information barriers
Resources
Shield information barrierShield information barrier (Base)List of Shield Information Barriers
Endpoints
GETGet shield information barrier with specified IDGETList shield information barriersPOSTAdd changed status of shield information barrier with specified IDPOSTCreate shield information barrier
Sign requests
Resources
Sign Request (Base)Sign RequestBox Sign
Endpoints
GETGet sign request by IDGETList sign requestsPOSTResend sign requestPOSTCancel sign requestPOSTCreate sign request
Sign templates
Resources
Box Sign templateBox Sign templates
Endpoints
GETList Box Sign templatesGETGet Box Sign template by ID
Skills
Resources
Skills metadata instanceKeyword Skill CardTimeline Skill CardTranscript Skill CardStatus Skill CardSkill webhook payload
Endpoints
GETList Box Skill cards on filePOSTCreate Box Skill cards on filePUTUpdate Box Skill cards on filePUTUpdate all Box Skill cards on fileDELRemove Box Skill cards from file
Standard and Zones Storage Policies
Resources
Storage policyStorage policy (Mini)Storage policies
Endpoints
GETGet storage policyGETList storage policies
Standard and Zones Storage Policy Assignments
Resources
Storage policy assignmentStorage policy assignments
Endpoints
GETGet storage policy assignmentGETList storage policy assignmentsPOSTAssign storage policyPUTUpdate storage policy assignmentDELUnassign storage policy
Task assignments
Resources
Task assignmentTask assignments
Endpoints
GETList task assignmentsGETGet task assignmentPOSTAssign taskPUTUpdate task assignmentDELUnassign task
Tasks
Resources
TaskTasks
Endpoints
GETList tasks on fileGETGet taskPOSTCreate taskPUTUpdate taskDELRemove task
Terms of service
Resources
Terms of serviceTerms of servicesTerms of service (Base)
Endpoints
GETList terms of servicesGETGet terms of servicePOSTCreate terms of servicePUTUpdate terms of service
Terms of service user statuses
Resources
Terms of service user statusTerms of service user statuses
Endpoints
GETList terms of service user statusesPOSTCreate terms of service status for new userPUTUpdate terms of service status for existing user
Transfer folders
Endpoints
PUTTransfer owned folders
Trashed files
Resources
Trashed FileTrashed File (Restored)
Endpoints
GETGet trashed filePOSTRestore fileDELPermanently remove file
Trashed folders
Resources
Trashed FolderTrashed Folder (Restored)
Endpoints
GETGet trashed folderPOSTRestore folderDELPermanently remove folder
Trashed items
Endpoints
GETList trashed items
Trashed web links
Resources
Trashed Web LinkTrashed Web Link (Restored)
Endpoints
GETGet trashed web linkPOSTRestore web linkDELPermanently remove web link
Uploads
Resources
Conflict errorUpload URL
Endpoints
OPTSPreflight check before uploadPOSTUpload file versionPOSTUpload file
Uploads (Chunked)
Resources
Upload partUpload part (Mini)Uploaded partUpload partsUpload session
Endpoints
GETGet upload sessionGETList partsPOSTCreate upload sessionPOSTCreate upload session for existing filePOSTCommit upload sessionPUTUpload part of fileDELRemove upload session
User avatars
Resources
User avatar
Endpoints
GETGet user avatarPOSTAdd or update user avatarDELDelete user avatar
Users
Resources
UserUsersUser (Full)User (Mini)User (Base)User (Collaborations)User (Integration Mappings)
Endpoints
GETList enterprise usersGETGet current userGETGet userPOSTCreate userPUTUpdate userDELDelete user
Watermarks (Files)
Resources
Watermark
Endpoints
GETGet watermark on filePUTApply watermark to fileDELRemove watermark from file
Watermarks (Folders)
Endpoints
GETGet watermark for folderPUTApply watermark to folderDELRemove watermark from folder
Web links
Resources
Web linkWeb link (Base)Web link (Mini)
Endpoints
GETGet web linkPOSTCreate web linkPUTUpdate web linkDELRemove web link
Webhooks
Resources
WebhookWebhook (Mini)Webhook (V2) payloadWebhooks
Endpoints
GETGet webhookGETList all webhooksPOSTCreate webhookPUTUpdate webhookDELRemove webhook
Workflows
Resources
WorkflowWorkflow (Full)Workflow (Mini)Workflows
Endpoints
GETList workflowsPOSTStarts workflow based on request body
Zip Downloads
Resources
Zip downloadZip download status
Endpoints
GETDownload zip archiveGETGet zip download statusPOSTCreate zip download
Resources
Access tokenClassificationClassification TemplateClient errorCollaborationAllowed collaboration domainsAllowed collaboration domainAllowed collaboration domains user exemptionAllowed collaboration domains user exemptionsCollaborations
CollectionCollectionsCommentComment (Base)Comment (Full)CommentsConflict errorDevice pinnerDevice pinnersEmail alias
Email aliasesEnterprise (Base)EventEvent sourceEventsFileFile (Base)File (Full)File (Mini)File (Conflict)
File RequestFile versionFile version (Base)File version (Full)File version (Mini)File version legal holdFile version legal holdsFile version retentionFile version retentionsFile versions
FilesFiles under retentionFolderFolder (Base)Folder (Full)Folder (Mini)Folder LockFolder LocksGroupGroup (Base)
Group (Full)Group (Mini)Group membershipGroup membershipsGroupsIntegration mappingIntegration mapping (Base)Integration mapping (Mini)Create integration mapping requestIntegration mappings
InviteItemsKeyword Skill CardLegal hold policiesLegal hold policyLegal hold policy (Mini)Legal hold policy assignmentLegal hold policy assignment (Base)Legal hold policy assignmentsMetadata instance
Metadata instance (Base)Metadata instance (Full)Metadata cascade policiesMetadata cascade policyMetadata 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 indexMetadata query indicesMetadata query search resultsMetadata templateMetadata templatesMetadata instancesOAuth 2.0 errorReal-time serverReal-time serversRecent item
Recent itemsRetention policiesRetention policyRetention policy (Base)Retention policy (Mini)Retention policy assignmentRetention policy assignment (Base)Retention policy assignmentsSearch Result (including Shared Link)Search Results
Search Results (including Shared Links)Session termination messageShield information barrierShield information barrier (Base)Shield information barrier referenceShield information barrier reportShield information barrier report (Base)Shield information barrier report detailsList of Shield Information Barrier ReportsShield information barrier segment
Shield information barrier segment memberShield information barrier segment member (Base)Shield information barrier segment member (Mini)List of Shield Information Barrier Segment MembersShield information barrier segment restrictionShield information barrier segment restriction (Base)Shield information barrier segment restriction (Mini)List of Shield Information Barrier Segment RestrictionsList of Shield Information Barrier SegmentsList of Shield Information Barriers
Sign RequestSign Request (Base)Box SignBox Sign templateBox Sign templatesSkills metadata instanceSkill webhook payloadStatus Skill CardStorage policiesStorage policy
Storage policy (Mini)Storage policy assignmentStorage policy assignmentsTaskTask assignmentTask assignmentsTasksTerms of serviceTerms of service (Base)Terms of service user status
Terms of servicesTerms of service user statusesTimeline Skill CardTranscript Skill CardTrashed FileTrashed File (Restored)Trashed FolderTrashed Folder (Restored)Trashed Web LinkTrashed Web Link (Restored)
Upload partUpload part (Mini)Upload partsUpload sessionUpload URLUploaded partUserUser (Base)User (Full)User (Mini)
User avatarUser (Collaborations)User (Integration Mappings)UsersWatermarkWeb linkWeb link (Base)Web link (Mini)WebhookWebhook (Mini)
Webhook (V2) payloadWebhooksWorkflowWorkflow (Full)Workflow (Mini)WorkflowsZip downloadZip download status