---
title: "Add classification to folder"
method: POST
path: "/folders/{folder_id}/metadata/enterprise/securityClassification-6VMVochwUWo"
tags: ["Classifications on folders"]
---

# Add classification to folder

`POST /folders/{folder_id}/metadata/enterprise/securityClassification-6VMVochwUWo`

Adds a classification to a folder by specifying the label of the
classification to add.

This API can also be called by including the enterprise ID in the
URL explicitly, for example
`/folders/:id/enterprise_12345/securityClassification-6VMVochwUWo`.

## Path parameters

- `folder_id` string, required

## Request body

- object
  - `Box__Security__Classification__Key` string — 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.

## Response `201`

Returns the classification template instance
that was applied to the folder.

- Classification — An instance of the classification metadata template, containing the classification applied to the file or folder. To get more details about the classification applied to an item, request the classification metadata template.
  - `Box__Security__Classification__Key` string — The name of the classification applied to the item.
  - `$parent` string — 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`.
  - `$scope` string — The scope of the enterprise that this classification has been applied for. This will be in the format `enterprise_{enterprise_id}`.
  - `$version` integer — The version of the metadata instance. This version starts at 0 and increases every time a classification is updated.
  - `$type` string — The unique ID of this classification instance. This will be include the name of the classification template and a unique ID.
  - `$typeVersion` number — 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.
  - `$canEdit` boolean — Whether an end user can change the classification.

## Other responses

- `400` — Returns an error when the request body is not valid. * `schema_validation_failed` - The request body contains a value for a field that either does not exist, or for which the value or type does not match the expected field type. An example might be an unknown option for an `enum` or `multiSelect` field.
- `404` — Returns an error when the folder or metadata template was not found. * `not_found` - The folder could not be found, or the user does not have access to the folder. * `instance_tuple_not_found` - The metadata template was not found.
- `409` — Returns an error when an instance of this metadata template is already present on the folder. * `tuple_already_exists` - An instance of them metadata template already exists on the folder.
- `default` — An unexpected client error.

---

[API](https://skmtc.net/box/apis/platform-api.md) · [All operations](https://skmtc.net/box/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/box/platform-api/revisions/ba8f087e1a4d/schema)