Sample - Box Platform API
DELETE/metadata_cascade_policies/{metadata_cascade_policy_id}

Remove a metadata cascade policy

Deletes a metadata cascade policy. Use metadata_cascade_policy_id to identify the policy you want to remove; a successful request returns no response body.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 parameter
metadata_cascade_policy_idstringrequired
The unique identifier of the metadata cascade policy to delete.

3 status codes
204Returns an empty response when the metadata cascade policy is successfully deleted.
404Returned when the policy cannot be found, or when its folder cannot be found or the authenticated user does not have access to it.
typestringoptional
The value will always be `error`.
Allowed:error
statusintegeroptional
The HTTP status of the response.
codestringoptional
A Box-specific error code.
Allowed:createdacceptedno_contentredirectnot_modifiedbad_requestunauthorizedforbiddennot_foundmethod_not_allowedconflictprecondition_failed
messagestringoptional
A short message describing the error.
context_infoobjectoptional
A free-form object that contains additional context about the error. The possible fields are defined on a per-endpoint basis. `message` is only one example.
help_urlstringoptional
A URL that links to more information about why this error occurred.
request_idstringoptional
A unique identifier for this response, which can be used when contacting Box support.
defaultReturned when an unexpected client error occurs.
typestringoptional
The value will always be `error`.
Allowed:error
statusintegeroptional
The HTTP status of the response.
codestringoptional
A Box-specific error code.
Allowed:createdacceptedno_contentredirectnot_modifiedbad_requestunauthorizedforbiddennot_foundmethod_not_allowedconflictprecondition_failed
messagestringoptional
A short message describing the error.
context_infoobjectoptional
A free-form object that contains additional context about the error. The possible fields are defined on a per-endpoint basis. `message` is only one example.
help_urlstringoptional
A URL that links to more information about why this error occurred.
request_idstringoptional
A unique identifier for this response, which can be used when contacting Box support.

Error handling

A 404 is returned when the metadata cascade policy cannot be found, or when its folder cannot be found or is inaccessible to the authenticated user. metadata_cascade_policy_id must identify the policy you want to delete.