Box Developer Documentation

Supported APIs for Box Archive

Guides Box Archive Supported APIs for Box Archive
Edit this page

Supported APIs for Box Archive

The basic Box Archive APIs allow you to create, list and delete archives, but you can use other APIs to interact with an archive or its content. See the table below for the full list of those APIs.

Those APIs require the GCM scope to be enabled in your application. This scope is not available in the Developer Console and needs to be enabled by contacting customer support.

Additionally, some of the below APIs need to be enabled by contacting customer support to properly work with Box Archive. When contacting customer support, specify the user ID you plan to use those APIs with.

API EndpointDescription
POST /archivesCreate an archive.
GET /archivesList all archives.
DELETE /archives/:idDelete an archive.
PUT /files/:idAdd a file to an archive, restore a file from an archive, or move file within/between archives. Other updates to the file are not allowed. Requires contacting customer support to enable.
PUT /folders/:idAdd a folder to an archive, restore a folder from an archive, or move folder within/between archives. Other updates to the folder are not allowed. Requires contacting customer support to enable.
POST /files/contentUpload a file to an archive or to folder within archive. Requires contacting customer support to enable.
GET /files/:id/contentDownload a file from an archive or from folder within archive.
POST /zip_downloadsDownload a zip file of an archive or of a folder within archive.
POST /foldersCreate a folder within an archive. Requires contacting customer support to enable.
GET /files/:idGet details of a file within an archive.
GET /folders/:idGet details of archive or a folder within an archive.
GET /folders/:id/itemsList items within an archive or a folder within an archive.
POST /files/:id/copyCopy a file within an archive or to another archive.
POST /folders/:id/copyCopy a folder within an archive or to another archive.
POST /files/:id/metadata/:scope/:template_keyCreate metadata instance on a file within an archive.
GET /files/:id/metadata/:scope/:template_keyView metadata instance on a file within an archive.
GET /files/:id/metadataList all metadata instances on a file within an archive.
PUT /files/:id/metadata/:scope/:template_keyUpdate metadata instance on a file within an archive.
DELETE /files/:id/metadata/:scope/:template_keyDelete metadata instance on a file within an archive.
POST securityClassificationCreate a classification label on a file within an archive.
GET securityClassificationView a classification label on a file within an archive.
PUT securityClassificationUpdate a classification label on a file within an archive.
DELETE securityClassificationDelete a classification label on a file within an archive.