Skip to main content
GET
/
metadata_templates
/
enterprise
/
securityClassification-6VMVochwUWo
/
schema
List all classifications
curl --request GET \
  --url https://api.box.com/2.0/metadata_templates/enterprise/securityClassification-6VMVochwUWo/schema \
  --header 'Authorization: Bearer <token>'
{
  "id": "58063d82-4128-7b43-bba9-92f706befcdf",
  "type": "metadata_template",
  "scope": "enterprise_123456",
  "templateKey": "securityClassification-6VMVochwUWo",
  "displayName": "Classification",
  "fields": [
    {
      "id": "822227e0-47a5-921b-88a8-494760b2e6d2",
      "type": "enum",
      "key": "Box__Security__Classification__Key",
      "displayName": "Classification",
      "options": [
        {
          "id": "46aea176-3483-4431-856c-6b5b13d1cc50",
          "key": "Sensitive",
          "staticConfig": {
            "classification": {
              "classificationDefinition": "Sensitive information",
              "colorID": 4
            }
          }
        }
      ],
      "hidden": false
    }
  ],
  "hidden": false,
  "copyInstanceOnItemCopy": true
}
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.

Response

Returns the securityClassification metadata template, which contains a Box__Security__Classification__Key field that lists all the classifications available to this enterprise.

A metadata template that holds the security classifications defined by an enterprise.

​
id
string
required

The ID of the classification template.

Example:

"58063d82-4128-7b43-bba9-92f706befcdf"

​
type
enum<string>
required

The value will always be metadata_template.

Available options:
metadata_template
Example:

"metadata_template"

​
scope
string
required

The scope of the classification template. This is in the format enterprise_{id} where the id is the enterprise ID.

Example:

"enterprise_123456"

​
templateKey
enum<string>
required

The value will always be securityClassification-6VMVochwUWo.

Available options:
securityClassification-6VMVochwUWo
Example:

"securityClassification-6VMVochwUWo"

​
displayName
enum<string>
required

The name of this template as shown in web and mobile interfaces.

Available options:
Classification
Example:

"Classification"

​
fields
object[]
required

A list of fields for this classification template. This includes only one field, the Box__Security__Classification__Key, which defines the different classifications available in this enterprise.

Required array length: 1 element
​
hidden
boolean

Determines if the template is always available in web and mobile interfaces.

Example:

false

​
copyInstanceOnItemCopy
boolean

Determines if classifications are copied along when the file or folder is copied.

Example:

true