Skip to content

Latest commit

 

History

History
159 lines (104 loc) · 6.38 KB

FolderClassifications.md

File metadata and controls

159 lines (104 loc) · 6.38 KB

IFolderClassificationsManager

Get classification on folder

Retrieves the classification metadata instance that has been applied to a folder.

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

This operation is performed by calling function GetClassificationOnFolder.

See the endpoint docs at API Reference.

await client.FolderClassifications.GetClassificationOnFolderAsync(folderId: folder.Id);

Arguments

  • folderId string
    • The unique identifier that represent a folder. The ID for any folder can be determined by visiting this folder in the web application and copying the ID from the URL. For example, for the URL https://*.app.box.com/folder/123 the folder_id is 123. The root folder of a Box account is always represented by the ID 0. Example: "12345"
  • headers GetClassificationOnFolderHeaders
    • Headers of getClassificationOnFolder method
  • cancellationToken System.Threading.CancellationToken?
    • Token used for request cancellation.

Returns

This function returns a value of type Classification.

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

Add classification to folder

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.

This operation is performed by calling function AddClassificationToFolder.

See the endpoint docs at API Reference.

await client.FolderClassifications.AddClassificationToFolderAsync(folderId: folder.Id, requestBody: new AddClassificationToFolderRequestBody() { BoxSecurityClassificationKey = classification.Key });

Arguments

  • folderId string
    • The unique identifier that represent a folder. The ID for any folder can be determined by visiting this folder in the web application and copying the ID from the URL. For example, for the URL https://*.app.box.com/folder/123 the folder_id is 123. The root folder of a Box account is always represented by the ID 0. Example: "12345"
  • requestBody AddClassificationToFolderRequestBody
    • Request body of addClassificationToFolder method
  • headers AddClassificationToFolderHeaders
    • Headers of addClassificationToFolder method
  • cancellationToken System.Threading.CancellationToken?
    • Token used for request cancellation.

Returns

This function returns a value of type Classification.

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

Update classification on folder

Updates a classification on a folder.

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

This operation is performed by calling function UpdateClassificationOnFolder.

See the endpoint docs at API Reference.

await client.FolderClassifications.UpdateClassificationOnFolderAsync(folderId: folder.Id, requestBody: Array.AsReadOnly(new [] {new UpdateClassificationOnFolderRequestBody(value: secondClassification.Key)}));

Arguments

  • folderId string
    • The unique identifier that represent a folder. The ID for any folder can be determined by visiting this folder in the web application and copying the ID from the URL. For example, for the URL https://*.app.box.com/folder/123 the folder_id is 123. The root folder of a Box account is always represented by the ID 0. Example: "12345"
  • requestBody IReadOnlyList<UpdateClassificationOnFolderRequestBody>
    • Request body of updateClassificationOnFolder method
  • headers UpdateClassificationOnFolderHeaders
    • Headers of updateClassificationOnFolder method
  • cancellationToken System.Threading.CancellationToken?
    • Token used for request cancellation.

Returns

This function returns a value of type Classification.

Returns the updated classification metadata template instance.

Remove classification from folder

Removes any classifications from a folder.

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

This operation is performed by calling function DeleteClassificationFromFolder.

See the endpoint docs at API Reference.

await client.FolderClassifications.DeleteClassificationFromFolderAsync(folderId: folder.Id);

Arguments

  • folderId string
    • The unique identifier that represent a folder. The ID for any folder can be determined by visiting this folder in the web application and copying the ID from the URL. For example, for the URL https://*.app.box.com/folder/123 the folder_id is 123. The root folder of a Box account is always represented by the ID 0. Example: "12345"
  • headers DeleteClassificationFromFolderHeaders
    • Headers of deleteClassificationFromFolder method
  • cancellationToken System.Threading.CancellationToken?
    • Token used for request cancellation.

Returns

This function returns a value of type null.

Returns an empty response when the classification is successfully deleted.