Retention Policy Assignment

The retention policy assignment endpoint provides a way for admins to apply a retention policy on a per-folder basis, or place a blanket policy over the entire enterprise.

string / date-time

When the retention policy assignment object was created

A mini user object representing the user that created the retention policy assignment object

The type and id of the content that is under retention. The type can either be folder or enterprise.


The unique identifier for this object

A mini retention policy object representing the retention policy that has been assigned to this content


Value is always "retention_policy_assignment"

Response Example

  "id": 11446498,
  "type": "retention_policy_assignment",
  "retention_policy": {
    "id": 12345,
    "type": "file_version",
    "policy_name": "Some Policy Name",
    "retention_length": 0,
    "disposition_action": "permanently_delete"
  "assigned_to": {
    "id": 11446498
  "assigned_by": {
    "id": 11446498,
    "type": "user",
    "name": "Aaron Levie",
    "login": ""
  "assigned_at": "2012-12-12T10:53:43-08:00"