> ## Documentation Index
> Fetch the complete documentation index at: https://developer.box.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Archives resources

A set of endpoints used to manage archives.

## Archive

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.

<Accordion title="Attributes and example">
  | Property      | Type           | Required | Description                                                                                                                                                                                                                                  |
  | ------------- | -------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `id`          | `string`       | Yes      | The unique identifier that represents an archive.                                                                                                                                                                                            |
  | `type`        | `enum<string>` | Yes      | The value is always `archive`. Available options: `archive`.                                                                                                                                                                                 |
  | `name`        | `string`       | Yes      | 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. |
  | `size`        | `integer`      | Yes      | The size of the archive in bytes.                                                                                                                                                                                                            |
  | `description` | `string`       | No       | The description of the archive. Can be `null`.                                                                                                                                                                                               |
  | `owned_by`    | `object`       | No       | The part of an archive API response that describes the user who owns the archive.                                                                                                                                                            |

  ```json Example theme={null}
  {
    "id": "12345",
    "type": "archive",
    "name": "Archive",
    "size": 123456789,
    "description": "This is an archive for important documents.",
    "owned_by": {
      "id": "12345",
      "type": "user"
    }
  }
  ```
</Accordion>

## Archives

A list of archives.

<Accordion title="Attributes and example">
  | Property      | Type                         | Required | Description                                                                                                                                                                            |
  | ------------- | ---------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `entries`     | array of [Archive](#archive) | No       | A list in which each entry represents an archive object.                                                                                                                               |
  | `limit`       | `integer`                    | No       | The limit that was used for these entries. This will be the same as the `limit` query parameter unless that value exceeded the maximum value allowed. The maximum value varies by API. |
  | `next_marker` | `string`                     | No       | The marker for the start of the next page of results. Can be `null`.                                                                                                                   |

  ```json Example theme={null}
  {
    "entries": [
      {
        "id": "12345",
        "type": "archive",
        "name": "Archive",
        "size": 123456789,
        "description": "This is an archive for important documents.",
        "owned_by": {
          "id": "12345",
          "type": "user"
        }
      }
    ],
    "limit": 1000,
    "next_marker": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii"
  }
  ```
</Accordion>