Box Developer Documentation

A beta version of the new Box developer documentation site is launching soon! Updated Developer Guides, modern API Reference, and AI-powered search are on the way to help you build with Box faster. Stay tuned for more updates.

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, update 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.
PUT /archives/:idUpdate an archive.
DELETE /archives/:idDelete an archive.
PUT /files/:idAdd a file to an archive, restore a file from an archive, or move a 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, move a folder within/between archives, or rename and change the description of a folder in an archive. Other updates to the folder are not allowed. Requires contacting customer support to enable.
POST /files/contentUpload a file to an archive or to a folder within an archive. Requires contacting customer support to enable.
GET /files/:id/contentDownload a file from an archive or from a folder within an archive.
POST /zip_downloadsDownload a zip file of an archive or of a folder within an 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 an archive or of a folder within an archive.
GET /folders/:id/itemsList items within an archive or items in a folder within an archive.
POST /files/:id/copyCopy a file to an archive.
POST /folders/:id/copyCopy a folder to an archive.
POST /files/:id/metadata/:scope/:template_keyCreate a metadata instance attached to a file within an archive.
GET /files/:id/metadata/:scope/:template_keyView a metadata instance attached to a file within an archive.
GET /files/:id/metadataList all metadata instances attached to a file within an archive.
PUT /files/:id/metadata/:scope/:template_keyUpdate a metadata instance attached to a file within an archive.
DELETE /files/:id/metadata/:scope/:template_keyDelete a metadata instance attached to a file within an archive.
POST securityClassificationCreate a classification label for a file within an archive.
GET securityClassificationView a classification label of a file within an archive.
PUT securityClassificationUpdate a classification label for a file within an archive.
DELETE securityClassificationDelete a classification label from a file within an archive.