Box Developer Documentation
Log in

Legal hold policy

Legal Hold Policy information describes the basic characteristics of the Policy, such as name, description, and filter dates.

object

Counts of assignments within this a legal hold policy by item type

integer / int64
3

The number of files this policy is applied to

integer / int64
4

The number of file versions this policy is applied to

integer / int64
2

The number of folders this policy is applied to

integer / int64
1

The number of users this policy is applied to

string / date-time
2012-12-12T10:53:43-08:00

When the legal hold policy object was created

User (Mini) object

The user who created the legal hold policy object

string / date-time
2012-12-12T10:53:43-08:00

When the policy release request was sent. (Because it can take time for a policy to fully delete, this isn't quite the same time that the policy is fully deleted).

If null, the policy was not deleted.

string
Postman created policy500

Description of the legal hold policy. Optional property with a 500 character limit.

string / date-time
2012-12-12T10:53:43-08:00

User-specified, optional date filter applies to Custodian assignments only

string / date-time
2012-12-12T10:53:43-08:00

User-specified, optional date filter applies to Custodian assignments only

string
11446498

The unique identifier for this object

string / date-time
2012-12-12T10:53:43-08:00

When the legal hold policy object was modified. Does not update when assignments are added or removed.

string
Policy 4254

Name of the legal hold policy.

string
Example500

Optional notes about why the policy was created.

string
active
  • 'active' - the policy is not in a transition state
  • 'applying' - that the policy is in the process of being applied
  • 'releasing' - that the process is in the process of being released
  • 'released' - the policy is no longer active

Value is one of active,applying,releasing,released

string
legal_hold_policy

Value is always legal_hold_policy

Response Example

{
  "assignment_counts": {
    "file": 3,
    "file_version": 4,
    "folder": 2,
    "user": 1
  },
  "created_at": "2012-12-12T10:53:43-08:00",
  "created_by": {
    "id": 11446498,
    "login": "ceo@example.com",
    "name": "Aaron Levie",
    "type": "user"
  },
  "deleted_at": "2012-12-12T10:53:43-08:00",
  "description": "Postman created policy",
  "filter_ended_at": "2012-12-12T10:53:43-08:00",
  "filter_started_at": "2012-12-12T10:53:43-08:00",
  "id": 11446498,
  "modified_at": "2012-12-12T10:53:43-08:00",
  "policy_name": "Policy 4",
  "release_notes": "Example",
  "status": "active",
  "type": "legal_hold_policy"
}