BObox
Classifications on files

Update classification on file

Changed on

Updates a classification on a file.

The classification can only be updated if a classification has already been applied to the file before. When editing classifications, only values are defined for the enterprise will be accepted.

put/files/{file_id}/metadata/enterprise/securityClassification-6VMVochwUWo

Request

  • Base URL
    https://api.box.com/2.0
  • URL
    https://api.box.com/2.0/files/{file_id}/metadata/enterprise/securityClassification-6VMVochwUWo
  • Auth
    OAuth 2
    Authorization code: https://account.box.com/api/oauth2/authorize
    Token URL: https://api.box.com/oauth2/token

Path parameters

file_idstring required

The unique identifier that represents a file.

The ID for any file can be determined by visiting a file in the web application and copying the ID from the URL. For example, for the URL https://*.app.box.com/files/123 the file_id is 123.

Request body

op'replace' required

The value will always be replace.

path'/Box__Security__Classification__Key' required

Defines classifications available in the enterprise.

valuestring required

The name of the classification to apply to this file.

To list the available classifications in an enterprise, use the classification API to retrieve the classification template which lists all available classification keys.

Example request

[
  {
    "op": "replace",
    "path": "/Box__Security__Classification__Key",
    "value": "Sensitive"
  }
]

Response

Returns the updated classification metadata template instance.

Box__Security__Classification__Keystring

The name of the classification applied to the item.

$parentstring

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}.

$template'securityClassification-6VMVochwUWo'

The value will always be securityClassification-6VMVochwUWo.

$scopestring

The scope of the enterprise that this classification has been applied for.

This will be in the format enterprise_{enterprise_id}.

$versioninteger

The version of the metadata instance. This version starts at 0 and increases every time a classification is updated.

$typestring

The unique ID of this classification instance. This will be include the name of the classification template and a unique ID.

$typeVersionnumber

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.

$canEditboolean

Whether an end user can change the classification.

Example response

{
  "Box__Security__Classification__Key": "Sensitive",
  "$parent": "folder_59449484661,",
  "$template": "securityClassification-6VMVochwUWo",
  "$scope": "enterprise_27335",
  "$version": 1,
  "$type": "securityClassification-6VMVochwUWo-fd31537a-0f95-4d86-9f2b-5974a29978f8",
  "$typeVersion": 5,
  "$canEdit": true
}

Changes

  • c4d5303fa5c3Revision changes
    • warning

      added the new unprocessable_entity enum value to the response property for the response status

    • warning

      added the new unprocessable_entity enum value to the response property for the response status

    • warning

      added the new unprocessable_entity enum value to the response property for the response status