Latest version

Delete retention policy

delete

https://api.box.com/2.0

/retention_policies/:retention_policy_id

This endpoint is in the version 2024.0. No changes are required to continue using it. For more details, see Box API versioning.

Permanently deletes a retention policy.

Request

authorizationbearer [ACCESS_TOKEN]

content-typeapplication/json

retention_policy_id stringin pathrequired

example982312

The ID of the retention policy.

204none

Returns an empty response when the policy has been deleted.

403application/jsonClient error

Returns an error if the policy is non-modifiable or the user does not have the required access to perform the action.

404application/jsonClient error

Returns an error if the policy is not found.

An unexpected client error.

delete

Delete retention policy

You can now try out some of our APIs live, right here in the documentation.

await client.retentionPolicies.deleteRetentionPolicyById(retentionPolicy.id);

client.retention_policies.delete_retention_policy_by_id(retention_policy.id)

await client.RetentionPolicies.DeleteRetentionPolicyByIdAsync(retentionPolicyId: retentionPolicy.Id);

try await client.retentionPolicies.deleteRetentionPolicyById(retentionPolicyId: retentionPolicy.id)