Sample - Box Platform API
PUT/folders/{folder_id}/metadata/enterprise/securityClassification-6VMVochwUWo

Update a folder classification

Updates the security classification metadata on a folder. Use a JSON Patch operation to replace the classification value, and only submit classifications defined for the enterprise. A classification must already be applied to the folder before you can update it.

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

1 parameter · 3 body fields
folder_idstringrequired
The unique identifier of the folder whose classification to update. Use `0` for the root folder.

A JSON Patch payload containing the change to make to the folder's classification metadata. Send the payload as application/json-patch+json and include the required items operation list.

opstringrequired
The value will always be `replace`.
Allowed:replace
pathstringrequired
Defines classifications available in the enterprise.
Allowed:/Box__Security__Classification__Key
valuestringrequired
The name of the classification to apply to this folder. To list the available classifications in an enterprise, use the classification API to retrieve the [classification template](https://developer.box.com/reference/get-metadata-templates-enterprise-securityClassification-6VMVochwUWo-schema) which lists all available classification keys.

4 status codes
200Returns the updated classification metadata template instance, including the applied classification, parent folder identifier, template scope, version information, and editability.
Box__Security__Classification__Keystringoptional
The name of the classification applied to the item.
$parentstringoptional
The identifier of the item that this metadata instance has been attached to. This combines the `type` and the `id` of the parent in the form `{type}_{id}`.
$templatestringoptional
The value will always be `securityClassification-6VMVochwUWo`.
Allowed:securityClassification-6VMVochwUWo
$scopestringoptional
The scope of the enterprise that this classification has been applied for. This will be in the format `enterprise_{enterprise_id}`.
$versionintegeroptional
The version of the metadata instance. This version starts at 0 and increases every time a classification is updated.
$typestringoptional
The unique ID of this classification instance. This will be include the name of the classification template and a unique ID.
$typeVersionnumberoptional
The version of the metadata template. This version starts at 0 and increases every time the template is updated. This is mostly for internal use.
$canEditbooleanoptional
Whether an end user can change the classification.
400Returned when the request body is not a valid array of JSON Patch operations.
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.
500Returned in edge cases when the request body is not a valid array of JSON Patch items.
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 for an unexpected client error, with an error object containing a message and request identifier.
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 400 is returned when the request body is not a valid array of JSON Patch operations. A 500 may be returned when the body is not a valid array of JSON Patch items. op must be replace, path must be /Box__Security__Classification__Key, and value must name a classification defined for the enterprise.