Join the first BoxWorks Hackathon for Good - customers, partners, and the developer community are welcome to participate in the 48 hour Hack to benefit The Nature Conservancy.

Learn more and register!
Box Developer Documentation
Log in

API Reference

Authorization
Resources
OAuth 2.0 errorAccess token
Endpoints
GETAuthorize userPOSTRequest access tokenPOSTRefresh access tokenPOSTRevoke access token
Box Sign
Resources
Sign RequestSign Requests
Endpoints
GETGet sign request by IDGETList sign requestsPOSTCancel sign requestPOSTResend sign requestPOSTCreate sign request
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
GETList users exempt from collaboration domain restrictionsGETGet user 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
GETList allowed collaboration domainsGETGet allowed collaboration domainPOSTAdd 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
EventEventsReal-time servers
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
GETList file version retentionsGETGet retention on file
File versions
Resources
File versions
Endpoints
GETList all file versionsGETGet file versionPOSTRevert 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
FolderFolder (Full)Folder (Mini)Folder (Base)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
Invites
Resources
Invite
Endpoints
GETGet user invite statusPOSTCreate user invite
Legal hold policies
Resources
Legal hold policyLegal hold policiesLegal hold policy (Mini)
Endpoints
GETList all legal hold policiesGETGet legal hold policyPOSTCreate legal hold policyPUTUpdate legal hold policyDELRemove legal hold policy
Legal hold policy assignments
Resources
Legal hold policy assignmentLegal hold policy assignment (Base)Legal hold policy assignments
Endpoints
GETList legal hold policy assignmentsGETGet legal hold policy assignmentGETList 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
GETList metadata cascade policiesGETGet metadata cascade policyPOSTCreate metadata cascade policyPOSTForce-apply metadata cascade policy to folderDELRemove metadata cascade policy
Metadata instances (Files)
Resources
Metadata instanceMetadata instance (Full)Metadata instance (Base)Metadata instances
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
GETFind metadata template by instance IDGETGet metadata template by nameGETGet metadata template by 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 policy
Retention policy assignments
Resources
Files under retentionRetention policy assignmentRetention policy assignments
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 query search resultsSearch ResultsSearch Results (including Shared Links)Search Result (including Shared Link)Metadata filter
Endpoints
GETList metadata query indicesGETSearch for contentPOSTQuery files/folders by metadata
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
Skills
Resources
Skill webhook payloadSkills metadata instanceSkill CardKeyword Skill CardTimeline Skill CardTranscript Skill CardStatus Skill Card
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 policiesStorage policy (Mini)
Endpoints
GETList storage policiesGETGet storage policy
Standard and Zones Storage Policy Assignments
Resources
Storage policy assignmentStorage policy assignments
Endpoints
GETList storage policy assignmentsGETGet storage policy assignmentPOSTAssign 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 (Mini)
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)
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
Webhook (V2) payloadWebhookWebhook (Mini)Webhooks
Endpoints
GETList all webhooksGETGet webhookPOSTCreate 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 aliasesEventEvent sourceEventsFileFile (Base)File (Full)File (Mini)File (Conflict)File Request
File versionFile version (Base)File version (Full)File version (Mini)File version legal holdFile version legal holdsFile version retentionFile version retentionsFile versionsFiles
Files under retentionFolderFolder (Base)Folder (Full)Folder (Mini)Folder LockFolder LocksGroupGroup (Base)Group (Full)
Group (Mini)Group membershipGroup membershipsGroupsInviteItemsKeyword Skill CardLegal hold policiesLegal hold policyLegal hold policy (Mini)
Legal hold policy assignmentLegal hold policy assignment (Base)Legal hold policy assignmentsMetadata instanceMetadata 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 filterMetadata query indexMetadata query indicesMetadata query search resultsMetadata templateMetadata templatesMetadata instances
OAuth 2.0 errorReal-time serverReal-time serversRecent itemRecent itemsRetention policiesRetention policyRetention policy (Base)Retention policy (Mini)Retention policy assignment
Retention policy assignmentsSearch Result (including Shared Link)Search ResultsSearch Results (including Shared Links)Sign RequestSign RequestsSkill CardSkills metadata instanceSkill webhook payloadStatus Skill Card
Storage policiesStorage policyStorage policy (Mini)Storage policy assignmentStorage policy assignmentsTaskTask assignmentTask assignmentsTasksTerms of service
Terms of service (Mini)Terms of service user statusTerms 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 avatarUsersWatermarkWeb linkWeb link (Base)Web link (Mini)WebhookWebhook (Mini)
Webhook (V2) payloadWebhooksWorkflowWorkflow (Full)Workflow (Mini)WorkflowsZip downloadZip download status