Skip to main content
POST
/
archives
cURL
curl -i -X POST "https://api.box.com/2.0/archives" \
     -H "box-version: 2025.0" \
     -H "authorization: Bearer <ACCESS_TOKEN>" \
     -H "content-type: application/json" \
     -d '{
       "name": "Some Archive Name",
       "description": "Some Archive Description"
     }'
{
  "id": "12345",
  "type": "archive",
  "name": "Archive",
  "size": 123456789,
  "description": "This is an archive for important documents.",
  "owned_by": {
    "id": "12345",
    "type": "user"
  }
}
Learn more about Box SDK versioning strategy.

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

​
box-version
enum<string>
required

Version header.

Available options:
2025.0

Body

application/json
​
name
string
required

The name of the archive.

Example:

"Some Archive"

​
description
string

The description of the archive.

Example:

"This is an archive for important documents."

​
storage_policy_id
string

The ID of the storage policy that the archive is assigned to.

Example:

"100001"

Response

Returns a new archive object.

An archive is a folder dedicated to storing content that is redundant, outdated, or trivial. Content in an archive is not accessible to its owner and collaborators. To use this feature, you must request GCM scope for your Box application.

​
id
string
required

The unique identifier that represents an archive.

Example:

"12345"

​
type
enum<string>
required

The value is always archive.

Available options:
archive
Example:

"archive"

​
name
string
required

The name of the archive.

The following restrictions to the archive name apply: names containing non-printable ASCII characters, forward and backward slashes (/, \), names with trailing spaces, and names . and .. are not allowed.

Required string length: 1 - 100
Example:

"Archive"

​
size
integer<int64>
required

The size of the archive in bytes.

Example:

123456789

​
description
string | null

The description of the archive.

Maximum string length: 255
Example:

"This is an archive for important documents."

​
owned_by
object

The part of an archive API response that describes the user who owns the archive.

Example:
{ "id": "12345", "type": "user" }