Skip to main content
DELETE
/
retention_policies
/
{retention_policy_id}
cURL
curl --request DELETE \
  --url https://api.box.com/2.0/retention_policies/{retention_policy_id} \
  --header 'Authorization: Bearer <token>'
{
  "type": "error",
  "status": 400,
  "code": "item_name_invalid",
  "message": "Method Not Allowed",
  "context_info": {
    "message": "Something went wrong"
  },
  "help_url": "https://developer.box.com/guides/api-calls/permissions-and-errors/common-errors/",
  "request_id": "abcdef123456"
}
This endpoint is in the version 2024.0. No changes are required to continue using it. For more details, see Box API versioning.Learn more about Box SDK versioning strategy.

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

​
retention_policy_id
string
required

The ID of the retention policy.

Response

Returns an empty response when the policy has been deleted.