File version retention
A retention policy blocks permanent deletion of content for a specified amount of time. Admins can apply policies to specified folders, or an entire enterprise. A file version retention is a record for a retained file version. To use this feature, you must have the manage retention policies scope enabled for your API key via your application management console. For more information about retention policies, please visit our help documentation
2012-12-12T10:53:43-08:00When this file version retention object was created
2012-12-12T10:53:43-08:00When the retention expires on this file version retention
The file this file version retention was applied to
The file version this file version retention was applied to
11446498The unique identifier for this object
file_version_retentionValue is always file_version_retention
The winning retention policy applied to this file version retention. A file version can have multiple retention policies applied.
Response Example
{
"applied_at": "2012-12-12T10:53:43-08:00",
"disposition_at": "2012-12-12T10:53:43-08:00",
"file": {
"etag": 1,
"id": 12345,
"name": "Contract.pdf",
"sequence_id": 3,
"type": "file"
},
"file_version": {
"id": 12345,
"sha1": "134b65991ed521fcfe4724b7d814ab8ded5185dc",
"type": "file_version"
},
"id": 11446498,
"type": "file_version_retention",
"winning_retention_policy": {
"disposition_action": "permanently_delete",
"id": 12345,
"policy_name": "Some Policy Name",
"retention_length": 365,
"type": "file_version"
}
}