Module box

ballerinax/box Ballerina library

1.5.1

Overview

This is a generated connector for Box Platform API v2.0.0 OpenAPI specification.

Box Platform provides functionality to provide access to content stored within Box. It provides endpoints for basic manipulation of files and folders, management of users within an enterprise, as well as more complex topics such as legal holds and retention policies.

Prerequisites

Before using this connector in your Ballerina application, complete the following:

Create Box Platform Account by selecting the pricing plan
Obtaining tokens
1. Go to Box Platform Account and log into the account
2. Navigate to developer console, create new app and get needed credentials
3. Create and obtain bearer token credentials and store somewhere securely

Quickstart

Step 1: Import connector

Import the ballerinax/box module into the Ballerina project.


import ballerinax/box;

Step 2: Create a new connector instance


configurable http:BearerTokenConfig & readonly auth = ?;
box:ClientConfig clientConfig = {
    auth : auth
};

box:Client baseClient = check new Client(clientConfig, serviceUrl = "https://api.box.com/2.0");

Step 3: Invoke connector operation

You can get a existing file by using getFilesId method.


box:File file = check baseClient->getFilesId("833080141230", "bal");

Use bal run command to compile and run the Ballerina program.

Clients

box: Client

Isolated

This is a generated connector for Box Platform API v2.0.0 OpenAPI specification. Box Platform provides functionality to provide access to content stored within Box. It provides endpoints for basic manipulation of files and folders, management of users within an enterprise, as well as more complex topics such as legal holds and retention policies.

Constructor

Gets invoked to initialize the connector. The connector initialization requires setting the API credentials. Create a Box Developer Account and obtain tokens following this guide.

init (ConnectionConfig config, string serviceUrl)

config ConnectionConfig - The configurations to be used when initializing the connector

serviceUrl string "https://api.box.com/2.0" - URL of the target service

getAuthorize

Isolated FunctionRemote Function

function getAuthorize(string responseType, string clientId, string? redirectUri, string? state, string? scope) returns string|error

Authorize user

Parameters

responseType string - The type of response we'd like to receive.

clientId string - The Client ID of the application that is requesting to authenticate the user. To get the Client ID for your application, log in to your Box developer console and click the Edit Application link for the application you're working with. In the OAuth 2.0 Parameters section of the configuration page, find the item labelled client_id. The text of that item is your application's Client ID.

redirectUri string? (default ()) - The URL to which Box redirects the browser after the user has granted or denied the application permission. This URL must match the redirect URL in the configuration of your application. It must be a valid HTTPS URL and it needs to be able to handle the redirection to complete the next step in the OAuth 2.0 flow.

state string? (default ()) - A custom string of your choice. Box will pass the same string to the redirect URL when authentication is complete. This parameter can be used to identify a user on redirect, as well as protect against hijacked sessions and other exploits.

scope string? (default ()) - A comma-separated list of application scopes you'd like to authenticate the user for. This defaults to all the scopes configured for the application in its configuration page.

Return Type

string|error - Does not return any data, but rather should be used in the browser.

postOauth2Token

Isolated FunctionRemote Function

function postOauth2Token(PostOAuth2Token payload) returns AccessToken|error

Request access token

Parameters

payload PostOAuth2Token -

Return Type

AccessToken|error - Returns a new Access Token that can be used to make authenticated API calls by passing along the token in a authorization header as follows Authorization: Bearer <Token>.

postOauth2TokenRefresh

Isolated FunctionRemote Function

function postOauth2TokenRefresh(Postoauth2tokenRefreshaccesstoken payload) returns AccessToken|error

Refresh access token

Parameters

payload Postoauth2tokenRefreshaccesstoken -

Return Type

AccessToken|error - Returns a new Access Token that can be used to make authenticated API calls by passing along the token in a authorization header as follows Authorization: Bearer <Token>.

postOauth2Revoke

Isolated FunctionRemote Function

function postOauth2Revoke(PostOAuth2Revoke payload) returns Response|error

Revoke access token

Parameters

payload PostOAuth2Revoke -

Return Type

Response|error - Returns an empty response when the token was successfully revoked.

getFilesId

Isolated FunctionRemote Function

function getFilesId(string fileId, string xRepHints, string[]? fields, string? ifNoneMatch, string? boxapi) returns File|error

Get file information

Parameters

fileId string - The unique identifier that represent 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.

xRepHints string - A header required to request specific representations of a file. Use this in combination with the fields query parameter to request a specific file representation. The general format for these representations is X-Rep-Hints: [...] where [...] is one or many hints in the format [fileType?query]. For example, to request a png representation in 32x32 as well as 94x94 pixel dimensions provide the following hints. X-Rep-Hints: [jpg?dimensions=32x32][jpg?dimensions=94x94] Additionally, a text representation is available for all document file types in Box using the [extracted_text] representation. X-Rep-Hints: [extracted_text]

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested. Additionally this field can be used to query any metadata applied to the file by specifying the metadata field as well as the scope and key of the template to retrieve, for example ?field=metadata.enterprise_12345.contractTemplate.

ifNoneMatch string? (default ()) - Ensures an item is only returned if it has changed. Pass in the item's last observed etag value into this header and the endpoint will fail with a 304 Not Modified if the item has not changed since.

boxapi string? (default ()) - The URL, and optional password, for the shared link of this item. This header can be used to access items that have not been explicitly shared with a user. Use the format shared_link=[link] or if a password is required then use shared_link=[link]&shared_link_password=[password]. This header can be used on the file or folder shared, as well as on any files or folders nested within the item.

Return Type

File|error - Returns a file object. Not all available fields are returned by default. Use the fields query parameter to explicitly request any specific fields.

putFilesId

Isolated FunctionRemote Function

function putFilesId(string fileId, FilesFileIdBody payload, string[]? fields, string? ifMatch) returns File|error

Update file

Parameters

fileId string - The unique identifier that represent 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.

payload FilesFileIdBody -

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

ifMatch string? (default ()) - Ensures this item hasn't recently changed before making changes. Pass in the item's last observed etag value into this header and the endpoint will fail with a 412 Precondition Failed if it has changed since.

Return Type

File|error - Returns a file object. Not all available fields are returned by default. Use the fields query parameter to explicitly request any specific fields.

postFilesId

Isolated FunctionRemote Function

function postFilesId(string fileId, FilesFileIdBody1 payload, string[]? fields) returns File|error

Restore file

Parameters

fileId string - The unique identifier that represent 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.

payload FilesFileIdBody1 -

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

Return Type

File|error - Returns a file object when the file has been restored.

deleteFilesId

Isolated FunctionRemote Function

function deleteFilesId(string fileId, string? ifMatch) returns Response|error

Delete file

Parameters

fileId string - The unique identifier that represent 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.

ifMatch string? (default ()) - Ensures this item hasn't recently changed before making changes. Pass in the item's last observed etag value into this header and the endpoint will fail with a 412 Precondition Failed if it has changed since.

Return Type

Response|error - Returns an empty response when the file has been successfully deleted.

getFilesIdContent

Isolated FunctionRemote Function

function getFilesIdContent(string fileId, string? range, string? boxapi, string? 'version, string? accessToken) returns Response|error

Download file

Parameters

fileId string - The unique identifier that represent 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.

range string? (default ()) - The byte range of the content to download. The format {start_byte}-{end_byte} can be used to specify what section of the file to download.

boxapi string? (default ()) - The URL, and optional password, for the shared link of this item. This header can be used to access items that have not been explicitly shared with a user. Use the format shared_link=[link] or if a password is required then use shared_link=[link]&shared_link_password=[password]. This header can be used on the file or folder shared, as well as on any files or folders nested within the item.

'version string? (default ()) - The file version to download

accessToken string? (default ()) - An optional access token that can be used to pre-authenticate this request, which means that a download link can be shared with a browser or a third party service without them needing to know how to handle the authentication. When using this parameter, please make sure that the access token is sufficiently scoped down to only allow read access to that file and no other files or folders.

Return Type

Response|error - If the file is not ready to be downloaded yet Retry-After header will be returned indicating the time in seconds after which the file will be available for the client to download. This response can occur when the file was uploaded immediately before the download request.

postFilesIdContent

Isolated FunctionRemote Function

function postFilesIdContent(string fileId, FileIdContentBody payload, string? ifMatch, string[]? fields, string? contentMd5) returns Files|error

Upload file version

Parameters

fileId string - The unique identifier that represent 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.

payload FileIdContentBody -

ifMatch string? (default ()) - Ensures this item hasn't recently changed before making changes. Pass in the item's last observed etag value into this header and the endpoint will fail with a 412 Precondition Failed if it has changed since.

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

contentMd5 string? (default ()) - An optional header containing the SHA1 hash of the file to ensure that the file was not corrupted in transit.

Return Type

Files|error - Returns the new file object in a list.

postFilesContent

Isolated FunctionRemote Function

function postFilesContent(FilesContentBody payload, string[]? fields, string? contentMd5) returns Files|error

Upload file

Parameters

payload FilesContentBody -

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

contentMd5 string? (default ()) - An optional header containing the SHA1 hash of the file to ensure that the file was not corrupted in transit.

Return Type

Files|error - Returns the new file object in a list.

postFilesUploadSessions

Isolated FunctionRemote Function

function postFilesUploadSessions(FilesUploadSessionsBody payload) returns UploadSession|error

Create upload session

Parameters

payload FilesUploadSessionsBody -

Return Type

UploadSession|error - Returns a new upload session.

postFilesIdUploadSessions

Isolated FunctionRemote Function

function postFilesIdUploadSessions(string fileId, FileIdUploadSessionsBody payload) returns UploadSession|error

Create upload session for existing file

Parameters

fileId string - The unique identifier that represent 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.

payload FileIdUploadSessionsBody -

Return Type

UploadSession|error - Returns a new upload session.

getFilesUploadSessionsId

Isolated FunctionRemote Function

function getFilesUploadSessionsId(string uploadSessionId) returns UploadSession|error

Get upload session

Parameters

uploadSessionId string - The ID of the upload session.

Return Type

UploadSession|error - Returns an upload session object.

putFilesUploadSessionsId

Isolated FunctionRemote Function

function putFilesUploadSessionsId(string uploadSessionId, string digest, string contentRange, byte[] payload) returns UploadedPart|error

Upload part of file

Parameters

uploadSessionId string - The ID of the upload session.

digest string - The [RFC3230][1] message digest of the chunk uploaded. Only SHA1 is supported. The SHA1 digest must be Base64 encoded. The format of this header is as sha=BASE64_ENCODED_DIGEST. [1]: https://tools.ietf.org/html/rfc3230

contentRange string - The byte range of the chunk. Must not overlap with the range of a part already uploaded this session.

payload byte[] -

Return Type

UploadedPart|error - Chunk has been uploaded successfully.

deleteFilesUploadSessionsId

Isolated FunctionRemote Function

function deleteFilesUploadSessionsId(string uploadSessionId) returns Response|error

Remove upload session

Parameters

uploadSessionId string - The ID of the upload session.

Return Type

Response|error - A blank response is returned if the session was successfully aborted.

getFilesUploadSessionsIdParts

Isolated FunctionRemote Function

function getFilesUploadSessionsIdParts(string uploadSessionId, int offset, int? 'limit) returns UploadParts|error

List parts

Parameters

uploadSessionId string - The ID of the upload session.

offset int (default 0) - The offset of the item at which to begin the response.

'limit int? (default ()) - The maximum number of items to return per page.

Return Type

UploadParts|error - Returns a list of parts that have been uploaded.

postFilesUploadSessionsIdCommit

Isolated FunctionRemote Function

function postFilesUploadSessionsIdCommit(string uploadSessionId, string digest, UploadSessionIdCommitBody payload, string? ifMatch, string? ifNoneMatch) returns Files|error?

Commit upload session

Parameters

uploadSessionId string - The ID of the upload session.

digest string - The [RFC3230][1] message digest of the whole file. Only SHA1 is supported. The SHA1 digest must be Base64 encoded. The format of this header is as sha=BASE64_ENCODED_DIGEST. [1]: https://tools.ietf.org/html/rfc3230

payload UploadSessionIdCommitBody -

ifMatch string? (default ()) - Ensures this item hasn't recently changed before making changes. Pass in the item's last observed etag value into this header and the endpoint will fail with a 412 Precondition Failed if it has changed since.

ifNoneMatch string? (default ()) - Ensures an item is only returned if it has changed. Pass in the item's last observed etag value into this header and the endpoint will fail with a 304 Not Modified if the item has not changed since.

Return Type

Files|error? - Returns the file object in a list.

postFilesIdCopy

Isolated FunctionRemote Function

function postFilesIdCopy(string fileId, FileIdCopyBody payload, string[]? fields) returns File|error

Copy file

Parameters

fileId string - The unique identifier that represent 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.

payload FileIdCopyBody -

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

Return Type

File|error - Returns a new file object representing the copied file. Not all available fields are returned by default. Use the fields query parameter to explicitly request any specific fields.

getFilesIdThumbnailId

Isolated FunctionRemote Function

function getFilesIdThumbnailId(string fileId, string extension, int? minHeight, int? minWidth, int? maxHeight, int? maxWidth) returns string|error?

Get file thumbnail

Parameters

fileId string - The unique identifier that represent 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.

extension string - The file format for the thumbnail

minHeight int? (default ()) - The minimum height of the thumbnail

minWidth int? (default ()) - The minimum width of the thumbnail

maxHeight int? (default ()) - The maximum height of the thumbnail

maxWidth int? (default ()) - The maximum width of the thumbnail

Return Type

string|error? - When a thumbnail can be created the thumbnail data will be returned in the body of the response.

getFilesIdCollaborations

Isolated FunctionRemote Function

function getFilesIdCollaborations(string fileId, string[]? fields, int? 'limit, string? marker) returns Collaborations|error

List file collaborations

Parameters

fileId string - The unique identifier that represent 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.

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

'limit int? (default ()) - The maximum number of items to return per page.

marker string? (default ()) - Defines the position marker at which to begin returning results. This is used when paginating using marker-based pagination. This requires usemarker to be set to true.

Return Type

Collaborations|error - Returns a collection of collaboration objects. If there are no collaborations on this file an empty collection will be returned. This list includes pending collaborations, for which the status is set to pending, indicating invitations that have been sent but not yet accepted.

getFilesIdComments

Isolated FunctionRemote Function

function getFilesIdComments(string fileId, string[]? fields, int? 'limit, int offset) returns Comments|error

List file comments

Parameters

fileId string - The unique identifier that represent 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.

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

'limit int? (default ()) - The maximum number of items to return per page.

offset int (default 0) - The offset of the item at which to begin the response.

Return Type

Comments|error - Returns a collection of comment objects. If there are no comments on this file an empty collection will be returned.

getFilesIdTasks

Isolated FunctionRemote Function

function getFilesIdTasks(string fileId) returns Tasks|error

List tasks on file

Parameters

fileId string - The unique identifier that represent 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.

Return Type

Tasks|error - Returns a list of tasks on a file. If there are no tasks on this file an empty collection is returned instead.

getFilesIdTrash

Isolated FunctionRemote Function

function getFilesIdTrash(string fileId, string[]? fields) returns File|error

Get trashed file

Parameters

fileId string - The unique identifier that represent 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.

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

Return Type

File|error - Returns the file that was trashed, including information about when the it was moved to the trash.

deleteFilesIdTrash

Isolated FunctionRemote Function

function deleteFilesIdTrash(string fileId) returns Response|error

Permanently remove file

Parameters

fileId string - The unique identifier that represent 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.

Return Type

Response|error - Returns an empty response when the file was permanently deleted.

getFilesIdVersions

Isolated FunctionRemote Function

function getFilesIdVersions(string fileId, string[]? fields, int? 'limit, int offset) returns FileVersions|error

List all file versions

Parameters

fileId string - The unique identifier that represent 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.

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

'limit int? (default ()) - The maximum number of items to return per page.

offset int (default 0) - The offset of the item at which to begin the response.

Return Type

FileVersions|error - Returns an array of past versions for this file.

getFilesIdVersionsId

Isolated FunctionRemote Function

function getFilesIdVersionsId(string fileId, string fileVersionId, string[]? fields) returns FileVersion|error

Get file version

Parameters

fileId string - The unique identifier that represent 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.

fileVersionId string - The ID of the file version

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

Return Type

FileVersion|error - Returns a specific version of a file. Not all available fields are returned by default. Use the fields query parameter to explicitly request any specific fields.

deleteFilesIdVersionsId

Isolated FunctionRemote Function

function deleteFilesIdVersionsId(string fileId, string fileVersionId, string? ifMatch) returns Response|error

Remove file version

Parameters

fileId string - The unique identifier that represent 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.

fileVersionId string - The ID of the file version

ifMatch string? (default ()) - Ensures this item hasn't recently changed before making changes. Pass in the item's last observed etag value into this header and the endpoint will fail with a 412 Precondition Failed if it has changed since.

Return Type

Response|error - Returns an empty response when the file has been successfully deleted.

postFilesIdVersionsCurrent

Isolated FunctionRemote Function

function postFilesIdVersionsCurrent(string fileId, VersionsCurrentBody payload, string[]? fields) returns FileVersion|error

Revert file version

Parameters

fileId string - The unique identifier that represent 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.

payload VersionsCurrentBody -

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

Return Type

FileVersion|error - Returns a newly created file version object.

getFilesIdWatermark

Isolated FunctionRemote Function

function getFilesIdWatermark(string fileId) returns Watermark|error

Get watermark on file

Parameters

fileId string - The unique identifier that represent 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.

Return Type

Watermark|error - Returns an object containing information about the watermark associated for to this file.

putFilesIdWatermark

Isolated FunctionRemote Function

function putFilesIdWatermark(string fileId, FileIdWatermarkBody payload) returns Watermark|error

Apply watermark to file

Parameters

fileId string - The unique identifier that represent 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.

payload FileIdWatermarkBody -

Return Type

Watermark|error - Returns an updated watermark if a watermark already existed on this file.

deleteFilesIdWatermark

Isolated FunctionRemote Function

function deleteFilesIdWatermark(string fileId) returns Response|error

Remove watermark from file

Parameters

fileId string - The unique identifier that represent 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.

Return Type

Response|error - An empty response will be returned when the watermark was successfully deleted.

getFileRequestsId

Isolated FunctionRemote Function

function getFileRequestsId(string fileRequestId) returns FileRequest|error

Get file request

Parameters

fileRequestId string - The unique identifier that represent a file request. The ID for any file request can be determined by visiting a file request builder in the web application and copying the ID from the URL. For example, for the URL https://*.app.box.com/filerequest/123 the file_request_id is 123.

Return Type

FileRequest|error - Returns a file request object.

putFileRequestsId

Isolated FunctionRemote Function

function putFileRequestsId(string fileRequestId, FileRequestUpdateRequest payload, string? ifMatch) returns FileRequest|error

Update file request

Parameters

fileRequestId string - The unique identifier that represent a file request. The ID for any file request can be determined by visiting a file request builder in the web application and copying the ID from the URL. For example, for the URL https://*.app.box.com/filerequest/123 the file_request_id is 123.

payload FileRequestUpdateRequest -

ifMatch string? (default ()) - Ensures this item hasn't recently changed before making changes. Pass in the item's last observed etag value into this header and the endpoint will fail with a 412 Precondition Failed if it has changed since.

Return Type

FileRequest|error - Returns the updated file request object.

deleteFileRequestsId

Isolated FunctionRemote Function

function deleteFileRequestsId(string fileRequestId) returns Response|error

Delete file request

Parameters

fileRequestId string - The unique identifier that represent a file request. The ID for any file request can be determined by visiting a file request builder in the web application and copying the ID from the URL. For example, for the URL https://*.app.box.com/filerequest/123 the file_request_id is 123.

Return Type

Response|error - Returns an empty response when the file request has been successfully deleted.

postFileRequestsIdCopy

Isolated FunctionRemote Function

function postFileRequestsIdCopy(string fileRequestId, FileRequestCopyRequest payload) returns FileRequest|error

Copy file request

Parameters

fileRequestId string - The unique identifier that represent a file request. The ID for any file request can be determined by visiting a file request builder in the web application and copying the ID from the URL. For example, for the URL https://*.app.box.com/filerequest/123 the file_request_id is 123.

payload FileRequestCopyRequest -

Return Type

FileRequest|error - Returns updated file request object.

getFoldersId

Isolated FunctionRemote Function

function getFoldersId(string folderId, string[]? fields, string? ifNoneMatch, string? boxapi) returns Folder|error

Get folder information

Parameters

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.

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested. Additionally this field can be used to query any metadata applied to the file by specifying the metadata field as well as the scope and key of the template to retrieve, for example ?field=metadata.enterprise_12345.contractTemplate.

ifNoneMatch string? (default ()) - Ensures an item is only returned if it has changed. Pass in the item's last observed etag value into this header and the endpoint will fail with a 304 Not Modified if the item has not changed since.

boxapi string? (default ()) - The URL, and optional password, for the shared link of this item. This header can be used to access items that have not been explicitly shared with a user. Use the format shared_link=[link] or if a password is required then use shared_link=[link]&shared_link_password=[password]. This header can be used on the file or folder shared, as well as on any files or folders nested within the item.

Return Type

Folder|error - Returns a folder, including the first 100 entries in the folder. To fetch more items within the folder, please use the Get items in a folder endpoint. Not all available fields are returned by default. Use the fields query parameter to explicitly request any specific fields.

putFoldersId

Isolated FunctionRemote Function

function putFoldersId(string folderId, FoldersFolderIdBody payload, string[]? fields, string? ifMatch) returns Folder|error

Update folder

Parameters

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.

payload FoldersFolderIdBody -

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

ifMatch string? (default ()) - Ensures this item hasn't recently changed before making changes. Pass in the item's last observed etag value into this header and the endpoint will fail with a 412 Precondition Failed if it has changed since.

Return Type

Folder|error - Returns a folder object for the updated folder Not all available fields are returned by default. Use the fields query parameter to explicitly request any specific fields. This call will return synchronously. This holds true even when moving folders with a large a large number of items in all of its descendants. For very large folders, this means the call could take minutes or hours to return.

postFoldersId

Isolated FunctionRemote Function

function postFoldersId(string folderId, FoldersFolderIdBody1 payload, string[]? fields) returns Folder|error

Restore folder

Parameters

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.

payload FoldersFolderIdBody1 -

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

Return Type

Folder|error - Returns a folder object when the folder has been restored.

deleteFoldersId

Isolated FunctionRemote Function

function deleteFoldersId(string folderId, string? ifMatch, boolean? recursive) returns Response|error

Delete folder

Parameters

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.

ifMatch string? (default ()) - Ensures this item hasn't recently changed before making changes. Pass in the item's last observed etag value into this header and the endpoint will fail with a 412 Precondition Failed if it has changed since.

recursive boolean? (default ()) - Delete a folder that is not empty by recursively deleting the folder and all of its content.

Return Type

Response|error - Returns an empty response when the folder is successfully deleted or moved to the trash.

getFoldersIdItems

Isolated FunctionRemote Function

function getFoldersIdItems(string folderId, string[]? fields, boolean? usemarker, string? marker, int offset, int? 'limit, string? boxapi, string? sort, string? direction) returns Items|error

List items in folder

Parameters

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.

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested. Additionally this field can be used to query any metadata applied to the file by specifying the metadata field as well as the scope and key of the template to retrieve, for example ?field=metadata.enterprise_12345.contractTemplate.

usemarker boolean? (default ()) - Specifies whether to use marker-based pagination instead of offset-based pagination. Only one pagination method can be used at a time. By setting this value to true, the API will return a marker field that can be passed as a parameter to this endpoint to get the next page of the response.

marker string? (default ()) - Defines the position marker at which to begin returning results. This is used when paginating using marker-based pagination. This requires usemarker to be set to true.

offset int (default 0) - The offset of the item at which to begin the response.

'limit int? (default ()) - The maximum number of items to return per page.

boxapi string? (default ()) - The URL, and optional password, for the shared link of this item. This header can be used to access items that have not been explicitly shared with a user. Use the format shared_link=[link] or if a password is required then use shared_link=[link]&shared_link_password=[password]. This header can be used on the file or folder shared, as well as on any files or folders nested within the item.

sort string? (default ()) - Defines the second attribute by which items are sorted. Items are always sorted by their type first, with folders listed before files, and files listed before web links. This parameter is not supported for marker-based pagination on the root folder (the folder with an ID of 0).

direction string? (default ()) - The direction to sort results in. This can be either in alphabetical ascending (ASC) or descending (DESC) order.

Return Type

Items|error - Returns a collection of files, folders, and web links contained in a folder.

postFolders

Isolated FunctionRemote Function

function postFolders(FoldersBody payload, string[]? fields) returns Folder|error

Create folder

Parameters

payload FoldersBody -

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

Return Type

Folder|error - Returns a folder object. Not all available fields are returned by default. Use the fields query parameter to explicitly request any specific fields.

postFoldersIdCopy

Isolated FunctionRemote Function

function postFoldersIdCopy(string folderId, FolderIdCopyBody payload, string[]? fields) returns Folder|error

Copy folder

Parameters

folderId string - The unique identifier of the folder to copy. 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 with the ID 0 can not be copied.

payload FolderIdCopyBody -

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

Return Type

Folder|error - Returns a new folder object representing the copied folder. Not all available fields are returned by default. Use the fields query parameter to explicitly request any specific fields.

getFoldersIdCollaborations

Isolated FunctionRemote Function

function getFoldersIdCollaborations(string folderId, string[]? fields) returns Collaborations|error

List folder collaborations

Parameters

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.

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

Return Type

Collaborations|error - Returns a collection of collaboration objects. If there are no collaborations on this folder an empty collection will be returned. This list includes pending collaborations, for which the status is set to pending, indicating invitations that have been sent but not yet accepted.

getFoldersIdTrash

Isolated FunctionRemote Function

function getFoldersIdTrash(string folderId, string[]? fields) returns Folder|error

Get trashed folder

Parameters

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.

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

Return Type

Folder|error - Returns the folder that was trashed, including information about when the it was moved to the trash.

deleteFoldersIdTrash

Isolated FunctionRemote Function

function deleteFoldersIdTrash(string folderId) returns Response|error

Permanently remove folder

Parameters

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.

Return Type

Response|error - Returns an empty response when the folder was permanently deleted.

getFoldersTrashItems

Isolated FunctionRemote Function

function getFoldersTrashItems(string[]? fields, int? 'limit, int offset, boolean? usemarker, string? marker, string? direction, string? sort) returns Items|error

List trashed items

Parameters

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

'limit int? (default ()) - The maximum number of items to return per page.

offset int (default 0) - The offset of the item at which to begin the response.

usemarker boolean? (default ()) - Specifies whether to use marker-based pagination instead of offset-based pagination. Only one pagination method can be used at a time. By setting this value to true, the API will return a marker field that can be passed as a parameter to this endpoint to get the next page of the response.

marker string? (default ()) - Defines the position marker at which to begin returning results. This is used when paginating using marker-based pagination. This requires usemarker to be set to true.

direction string? (default ()) - The direction to sort results in. This can be either in alphabetical ascending (ASC) or descending (DESC) order.

sort string? (default ()) - Defines the second attribute by which items are sorted. Items are always sorted by their type first, with folders listed before files, and files listed before web links. This parameter is not supported when using marker-based pagination.

Return Type

Items|error - Returns a list of items that have been deleted

getFoldersIdWatermark

Isolated FunctionRemote Function

function getFoldersIdWatermark(string folderId) returns Watermark|error

Get watermark for folder

Parameters

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.

Return Type

Watermark|error - Returns an object containing information about the watermark associated for to this folder.

putFoldersIdWatermark

Isolated FunctionRemote Function

function putFoldersIdWatermark(string folderId, FolderIdWatermarkBody payload) returns Watermark|error

Apply watermark to folder

Parameters

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.

payload FolderIdWatermarkBody -

Return Type

Watermark|error - Returns an updated watermark if a watermark already existed on this folder.

deleteFoldersIdWatermark

Isolated FunctionRemote Function

function deleteFoldersIdWatermark(string folderId) returns Response|error

Remove watermark from folder

Parameters

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.

Return Type

Response|error - An empty response will be returned when the watermark was successfully deleted.

getFolderLocks

Isolated FunctionRemote Function

function getFolderLocks(string folderId) returns FolderLocks|error

List folder locks

Parameters

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.

Return Type

FolderLocks|error - Returns details for all folder locks applied to the folder, including the lock type and user that applied the lock.

postFolderLocks

Isolated FunctionRemote Function

function postFolderLocks(FolderLocksBody payload) returns FolderLock|error

Create folder lock

Parameters

payload FolderLocksBody -

Return Type

FolderLock|error - Returns the instance of the folder lock that was applied to the folder, including the user that applied the lock and the operations set.

deleteFolderLocksId

Isolated FunctionRemote Function

function deleteFolderLocksId(string folderLockId) returns Response|error

Delete folder lock

Parameters

folderLockId string - The ID of the folder lock.

Return Type

Response|error - Returns an empty response when the folder lock is successfully deleted.

getCommentsId

Isolated FunctionRemote Function

function getCommentsId(string commentId, string[]? fields) returns Comment|error

Get comment

Parameters

commentId string - The ID of the comment.

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

Return Type

Comment|error - Returns a full comment object.

putCommentsId

Isolated FunctionRemote Function

function putCommentsId(string commentId, CommentsCommentIdBody payload, string[]? fields) returns Comment|error

Update comment

Parameters

commentId string - The ID of the comment.

payload CommentsCommentIdBody -

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

Return Type

Comment|error - Returns the updated comment object.

deleteCommentsId

Isolated FunctionRemote Function

function deleteCommentsId(string commentId) returns Response|error

Remove comment

Parameters

commentId string - The ID of the comment.

Return Type

Response|error - Returns an empty response when the comment has been deleted.

postComments

Isolated FunctionRemote Function

function postComments(CommentsBody payload, string[]? fields) returns Comment|error

Create comment

Parameters

payload CommentsBody -

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

Return Type

Comment|error - Returns the newly created comment object. Not all available fields are returned by default. Use the fields query parameter to explicitly request any specific fields.

getCollaborationsId

Isolated FunctionRemote Function

function getCollaborationsId(string collaborationId, string[]? fields) returns Collaboration|error

Get collaboration

Parameters

collaborationId string - The ID of the collaboration

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

Return Type

Collaboration|error - Returns a collaboration object.

putCollaborationsId

Isolated FunctionRemote Function

function putCollaborationsId(string collaborationId, CollaborationsCollaborationIdBody payload) returns Collaboration|error

Update collaboration

Parameters

collaborationId string - The ID of the collaboration

payload CollaborationsCollaborationIdBody -

Return Type

Collaboration|error - Returns an updated collaboration object unless the owner has changed.

deleteCollaborationsId

Isolated FunctionRemote Function

function deleteCollaborationsId(string collaborationId) returns Response|error

Remove collaboration

Parameters

collaborationId string - The ID of the collaboration

Return Type

Response|error - A blank response is returned if the collaboration was successfully deleted.

getCollaborations

Isolated FunctionRemote Function

function getCollaborations(string status, string[]? fields, int offset, int? 'limit) returns Collaborations|error

List pending collaborations

Parameters

status string - The status of the collaborations to retrieve

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

offset int (default 0) - The offset of the item at which to begin the response.

'limit int? (default ()) - The maximum number of items to return per page.

Return Type

Collaborations|error - Returns a collection of pending collaboration objects. If the user has no pending collaborations, the collection will be empty.

postCollaborations

Isolated FunctionRemote Function

function postCollaborations(CollaborationsBody payload, string[]? fields, boolean? notify) returns Collaboration|error

Create collaboration

Parameters

payload CollaborationsBody -

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

notify boolean? (default ()) - Determines if users should receive email notification for the action performed.

Return Type

Collaboration|error - Returns a new collaboration object.

postTasks

Isolated FunctionRemote Function

function postTasks(TasksBody payload) returns Task|error

Create task

Parameters

payload TasksBody -

Return Type

Task|error - Returns the newly created task.

getTasksId

Isolated FunctionRemote Function

function getTasksId(string taskId) returns Task|error

Get task

Parameters

taskId string - The ID of the task.

Return Type

Task|error - Returns a task object.

putTasksId

Isolated FunctionRemote Function

function putTasksId(string taskId, TasksTaskIdBody payload) returns Task|error

Update task

Parameters

taskId string - The ID of the task.

payload TasksTaskIdBody -

Return Type

Task|error - Returns the updated task object

deleteTasksId

Isolated FunctionRemote Function

function deleteTasksId(string taskId) returns Response|error

Remove task

Parameters

taskId string - The ID of the task.

Return Type

Response|error - Returns an empty response when the task was successfully deleted.

getTasksIdAssignments

Isolated FunctionRemote Function

function getTasksIdAssignments(string taskId) returns TaskAssignments|error

List task assignments

Parameters

taskId string - The ID of the task.

Return Type

TaskAssignments|error - Returns a collection of task assignment defining what task on a file has been assigned to which users and by who.

postTaskAssignments

Isolated FunctionRemote Function

function postTaskAssignments(TaskAssignmentsBody payload) returns TaskAssignment|error

Assign task

Parameters

payload TaskAssignmentsBody -

Return Type

TaskAssignment|error - Returns a new task assignment object.

getTaskAssignmentsId

Isolated FunctionRemote Function

function getTaskAssignmentsId(string taskAssignmentId) returns TaskAssignment|error

Get task assignment

Parameters

taskAssignmentId string - The ID of the task assignment.

Return Type

TaskAssignment|error - Returns a task assignment, specifying who the task has been assigned to and by whom.

putTaskAssignmentsId

Isolated FunctionRemote Function

function putTaskAssignmentsId(string taskAssignmentId, TaskAssignmentsTaskAssignmentIdBody payload) returns TaskAssignment|error

Update task assignment

Parameters

taskAssignmentId string - The ID of the task assignment.

payload TaskAssignmentsTaskAssignmentIdBody -

Return Type

TaskAssignment|error - Returns the updated task assignment object.

deleteTaskAssignmentsId

Isolated FunctionRemote Function

function deleteTaskAssignmentsId(string taskAssignmentId) returns Response|error

Unassign task

Parameters

taskAssignmentId string - The ID of the task assignment.

Return Type

Response|error - Returns an empty response when the task assignment was successfully deleted.

getSharedItems

Isolated FunctionRemote Function

function getSharedItems(string boxapi, string? ifNoneMatch, string[]? fields) returns File|error

Find file for shared link

Parameters

boxapi string - A header containing the shared link and optional password for the shared link. The format for this header is as follows. shared_link=[link]&shared_link_password=[password]

ifNoneMatch string? (default ()) - Ensures an item is only returned if it has changed. Pass in the item's last observed etag value into this header and the endpoint will fail with a 304 Not Modified if the item has not changed since.

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

Return Type

File|error - Returns a full file resource if the shared link is valid and the user has access to it.

getFilesIdGetSharedLink

Isolated FunctionRemote Function

function getFilesIdGetSharedLink(string fileId, string fields) returns File|error

Get shared link for file

Parameters

fileId string - The unique identifier that represent 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.

fields string - Explicitly request the shared_link fields to be returned for this item.

Return Type

File|error - Returns the base representation of a file with the additional shared link information.

putFilesIdAddSharedLink

Isolated FunctionRemote Function

function putFilesIdAddSharedLink(string fileId, string fields, FilesFileIdaddSharedLinkBody payload) returns File|error

Add shared link to file

Parameters

fileId string - The unique identifier that represent 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.

fields string - Explicitly request the shared_link fields to be returned for this item.

payload FilesFileIdaddSharedLinkBody -

Return Type

File|error - Returns the base representation of a file with a new shared link attached.

putFilesIdUpdateSharedLink

Isolated FunctionRemote Function

function putFilesIdUpdateSharedLink(string fileId, string fields, FilesFileIdupdateSharedLinkBody payload) returns File|error

Update shared link on file

Parameters

fileId string - The unique identifier that represent 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.

fields string - Explicitly request the shared_link fields to be returned for this item.

payload FilesFileIdupdateSharedLinkBody -

Return Type

File|error - Returns a basic representation of the file, with the updated shared link attached.

putFilesIdRemoveSharedLink

Isolated FunctionRemote Function

function putFilesIdRemoveSharedLink(string fileId, string fields, FilesFileIdremoveSharedLinkBody payload) returns File|error

Remove shared link from file

Parameters

fileId string - The unique identifier that represent 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.

fields string - Explicitly request the shared_link fields to be returned for this item.

payload FilesFileIdremoveSharedLinkBody -

Return Type

File|error - Returns a basic representation of a file, with the shared link removed.

getSharedItemsFolders

Isolated FunctionRemote Function

function getSharedItemsFolders(string boxapi, string? ifNoneMatch, string[]? fields) returns Folder|error

Find folder for shared link

Parameters

boxapi string - A header containing the shared link and optional password for the shared link. The format for this header is as follows. shared_link=[link]&shared_link_password=[password]

ifNoneMatch string? (default ()) - Ensures an item is only returned if it has changed. Pass in the item's last observed etag value into this header and the endpoint will fail with a 304 Not Modified if the item has not changed since.

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

Return Type

Folder|error - Returns a full folder resource if the shared link is valid and the user has access to it.

getFoldersIdGetSharedLink

Isolated FunctionRemote Function

function getFoldersIdGetSharedLink(string folderId, string fields) returns Folder|error

Get shared link for folder

Parameters

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.

fields string - Explicitly request the shared_link fields to be returned for this item.

Return Type

Folder|error - Returns the base representation of a folder with the additional shared link information.

putFoldersIdAddSharedLink

Isolated FunctionRemote Function

function putFoldersIdAddSharedLink(string folderId, string fields, FoldersFolderIdaddSharedLinkBody payload) returns Folder|error

Add shared link to folder

Parameters

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.

fields string - Explicitly request the shared_link fields to be returned for this item.

payload FoldersFolderIdaddSharedLinkBody -

Return Type

Folder|error - Returns the base representation of a folder with a new shared link attached.

putFoldersIdUpdateSharedLink

Isolated FunctionRemote Function

function putFoldersIdUpdateSharedLink(string folderId, string fields, FoldersFolderIdupdateSharedLinkBody payload) returns Folder|error

Update shared link on folder

Parameters

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.

fields string - Explicitly request the shared_link fields to be returned for this item.

payload FoldersFolderIdupdateSharedLinkBody -

Return Type

Folder|error - Returns a basic representation of the folder, with the updated shared link attached.

putFoldersIdRemoveSharedLink

Isolated FunctionRemote Function

function putFoldersIdRemoveSharedLink(string folderId, string fields, FoldersFolderIdremoveSharedLinkBody payload) returns Folder|error

Remove shared link from folder

Parameters

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.

fields string - Explicitly request the shared_link fields to be returned for this item.

payload FoldersFolderIdremoveSharedLinkBody -

Return Type

Folder|error - Returns a basic representation of a folder, with the shared link removed.

postWebLinks

Isolated FunctionRemote Function

function postWebLinks(WebLinksBody payload) returns WebLink|error

Create web link

Parameters

payload WebLinksBody -

Return Type

WebLink|error - Returns the newly created web link object.

getWebLinksId

Isolated FunctionRemote Function

function getWebLinksId(string webLinkId, string? boxapi) returns WebLink|error

Get web link

Parameters

webLinkId string - The ID of the web link.

boxapi string? (default ()) - The URL, and optional password, for the shared link of this item. This header can be used to access items that have not been explicitly shared with a user. Use the format shared_link=[link] or if a password is required then use shared_link=[link]&shared_link_password=[password]. This header can be used on the file or folder shared, as well as on any files or folders nested within the item.

Return Type

WebLink|error - Returns the web link object.

putWebLinksId

Isolated FunctionRemote Function

function putWebLinksId(string webLinkId, WebLinksWebLinkIdBody payload) returns WebLink|error

Update web link

Parameters

webLinkId string - The ID of the web link.

payload WebLinksWebLinkIdBody -

Return Type

WebLink|error - Returns the updated web link object.

postWebLinksId

Isolated FunctionRemote Function

function postWebLinksId(string webLinkId, WebLinksWebLinkIdBody1 payload, string[]? fields) returns WebLink|error

Restore web link

Parameters

webLinkId string - The ID of the web link.

payload WebLinksWebLinkIdBody1 -

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

Return Type

WebLink|error - Returns a web link object when it has been restored.

deleteWebLinksId

Isolated FunctionRemote Function

function deleteWebLinksId(string webLinkId) returns Response|error

Remove web link

Parameters

webLinkId string - The ID of the web link.

Return Type

Response|error - An empty response will be returned when the web link was successfully deleted.

getWebLinksIdTrash

Isolated FunctionRemote Function

function getWebLinksIdTrash(string webLinkId, string[]? fields) returns Folder|error

Get trashed web link

Parameters

webLinkId string - The ID of the web link.

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

Return Type

Folder|error - Returns the web link that was trashed, including information about when the it was moved to the trash.

deleteWebLinksIdTrash

Isolated FunctionRemote Function

function deleteWebLinksIdTrash(string webLinkId) returns Response|error

Permanently remove web link

Parameters

webLinkId string - The ID of the web link.

Return Type

Response|error - Returns an empty response when the web link was permanently deleted.

getUsers

Isolated FunctionRemote Function

function getUsers(string? filterTerm, string? userType, string? externalAppUserId, string[]? fields, int offset, int? 'limit, boolean? usemarker, string? marker) returns Users|error

List enterprise users

Parameters

filterTerm string? (default ()) - Limits the results to only users who's name or login start with the search term. For externally managed users, the search term needs to completely match the in order to find the user, and it will only return one user at a time.

userType string? (default ()) - Limits the results to the kind of user specified. * all returns every kind of user for whom the login or name partially matches the filter_term. It will only return an external user if the login matches the filter_term completely, and in that case it will only return that user. * managed returns all managed and app users for whom the login or name partially matches the filter_term. * external returns all external users for whom the login matches the filter_term exactly.

externalAppUserId string? (default ()) - Limits the results to app users with the given external_app_user_id value. When creating an app user, an external_app_user_id value can be set. This value can then be used in this endpoint to find any users that match that external_app_user_id value.

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

offset int (default 0) - The offset of the item at which to begin the response.

'limit int? (default ()) - The maximum number of items to return per page.

usemarker boolean? (default ()) - Specifies whether to use marker-based pagination instead of offset-based pagination. Only one pagination method can be used at a time. By setting this value to true, the API will return a marker field that can be passed as a parameter to this endpoint to get the next page of the response.

marker string? (default ()) - Defines the position marker at which to begin returning results. This is used when paginating using marker-based pagination. This requires usemarker to be set to true.

Return Type

Users|error - Returns all of the users in the enterprise.

postUsers

Isolated FunctionRemote Function

function postUsers(UsersBody payload, string[]? fields) returns User|error

Create user

Parameters

payload UsersBody -

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

Return Type

User|error - Returns a user object for the newly created user.

getUsersMe

Isolated FunctionRemote Function

function getUsersMe(string[]? fields) returns User|error

Get current user

Parameters

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

Return Type

User|error - Returns a single user object.

getUsersId

Isolated FunctionRemote Function

function getUsersId(string userId, string[]? fields) returns User|error

Get user

Parameters

userId string - The ID of the user.

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

Return Type

User|error - Returns a single user object. Not all available fields are returned by default. Use the fields query parameter to explicitly request any specific fields using the fields parameter.

putUsersId

Isolated FunctionRemote Function

function putUsersId(string userId, UsersUserIdBody payload, string[]? fields) returns User|error

Update user

Parameters

userId string - The ID of the user.

payload UsersUserIdBody -

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

Return Type

User|error - Returns the updated user object.

deleteUsersId

Isolated FunctionRemote Function

function deleteUsersId(string userId, boolean? notify, boolean? force) returns Response|error

Delete user

Parameters

userId string - The ID of the user.

notify boolean? (default ()) - Whether the user will receive email notification of the deletion

force boolean? (default ()) - Whether the user should be deleted even if this user still own files

Return Type

Response|error - Removes the user and returns an empty response.

getUsersIdAvatar

Isolated FunctionRemote Function

function getUsersIdAvatar(string userId) returns string|error

Get user avatar

Parameters

userId string - The ID of the user.

Return Type

string|error - When an avatar can be found for the user the image data will be returned in the body of the response.

putUsersIdFolders0

Isolated FunctionRemote Function

function putUsersIdFolders0(string userId, Folders0Body payload, string[]? fields, boolean? notify) returns Folder|error

Transfer owned folders

Parameters

userId string - The ID of the user.

payload Folders0Body -

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

notify boolean? (default ()) - Determines if users should receive email notification for the action performed.

Return Type

Folder|error - Returns the information for the newly created destination folder.

getUsersIdEmailAliases

Isolated FunctionRemote Function

function getUsersIdEmailAliases(string userId) returns EmailAliases|error

List user's email aliases

Parameters

userId string - The ID of the user.

Return Type

EmailAliases|error - Returns a collection of email aliases.

postUsersIdEmailAliases

Isolated FunctionRemote Function

function postUsersIdEmailAliases(string userId, UserIdEmailAliasesBody payload) returns EmailAlias|error

Create email alias

Parameters

userId string - The ID of the user.

payload UserIdEmailAliasesBody -

Return Type

EmailAlias|error - Returns the newly created email alias object.

deleteUsersIdEmailAliasesId

Isolated FunctionRemote Function

function deleteUsersIdEmailAliasesId(string userId, string emailAliasId) returns Response|error

Remove email alias

Parameters

userId string - The ID of the user.

emailAliasId string - The ID of the email alias.

Return Type

Response|error - Removes the alias and returns an empty response.

getUsersIdMemberships

Isolated FunctionRemote Function

function getUsersIdMemberships(string userId, int? 'limit, int offset) returns GroupMemberships|error

List user's groups

Parameters

userId string - The ID of the user.

'limit int? (default ()) - The maximum number of items to return per page.

offset int (default 0) - The offset of the item at which to begin the response.

Return Type

GroupMemberships|error - Returns a collection of membership objects. If there are no memberships, an empty collection will be returned.

postInvites

Isolated FunctionRemote Function

function postInvites(InvitesBody payload, string[]? fields) returns Invite|error

Create user invite

Parameters

payload InvitesBody -

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

Return Type

Invite|error - Returns a new invite object.

getInvitesId

Isolated FunctionRemote Function

function getInvitesId(string inviteId, string[]? fields) returns Invite|error

Get user invite status

Parameters

inviteId string - The ID of an invite.

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

Return Type

Invite|error - Returns an invite object

getGroups

Isolated FunctionRemote Function

function getGroups(string? filterTerm, string[]? fields, int? 'limit, int offset) returns Groups|error

List groups for enterprise

Parameters

filterTerm string? (default ()) - Limits the results to only groups whose name starts with the search term.

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

'limit int? (default ()) - The maximum number of items to return per page.

offset int (default 0) - The offset of the item at which to begin the response.

Return Type

Groups|error - Returns a collection of group objects. If there are no groups, an empty collection will be returned.

postGroups

Isolated FunctionRemote Function

function postGroups(GroupsBody payload, string[]? fields) returns Group|error

Create group

Parameters

payload GroupsBody -

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

Return Type

Group|error - Returns the new group object.

getGroupsId

Isolated FunctionRemote Function

function getGroupsId(string groupId, string[]? fields) returns Group|error

Get group

Parameters

groupId string - The ID of the group.

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

Return Type

Group|error - Returns the group object

putGroupsId

Isolated FunctionRemote Function

function putGroupsId(string groupId, GroupsGroupIdBody payload, string[]? fields) returns Group|error

Update group

Parameters

groupId string - The ID of the group.

payload GroupsGroupIdBody -

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

Return Type

Group|error - Returns the updated group object.

deleteGroupsId

Isolated FunctionRemote Function

function deleteGroupsId(string groupId) returns Response|error

Remove group

Parameters

groupId string - The ID of the group.

Return Type

Response|error - A blank response is returned if the group was successfully deleted.

getGroupsIdMemberships

Isolated FunctionRemote Function

function getGroupsIdMemberships(string groupId, int? 'limit, int offset) returns GroupMemberships|error

List members of group

Parameters

groupId string - The ID of the group.

'limit int? (default ()) - The maximum number of items to return per page.

offset int (default 0) - The offset of the item at which to begin the response.

Return Type

GroupMemberships|error - Returns a collection of membership objects. If there are no memberships, an empty collection will be returned.

getGroupsIdCollaborations

Isolated FunctionRemote Function

function getGroupsIdCollaborations(string groupId, int? 'limit, int offset) returns Collaborations|error

List group collaborations

Parameters

groupId string - The ID of the group.

'limit int? (default ()) - The maximum number of items to return per page.

offset int (default 0) - The offset of the item at which to begin the response.

Return Type

Collaborations|error - Returns a collection of collaboration objects. If there are no collaborations, an empty collection will be returned.

postGroupMemberships

Isolated FunctionRemote Function

function postGroupMemberships(GroupMembershipsBody payload, string[]? fields) returns GroupMembership|error

Add user to group

Parameters

payload GroupMembershipsBody -

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

Return Type

GroupMembership|error - Returns a new group membership object.

getGroupMembershipsId

Isolated FunctionRemote Function

function getGroupMembershipsId(string groupMembershipId, string[]? fields) returns GroupMembership|error

Get group membership

Parameters

groupMembershipId string - The ID of the group membership.

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

Return Type

GroupMembership|error - Returns the group membership object.

putGroupMembershipsId

Isolated FunctionRemote Function

function putGroupMembershipsId(string groupMembershipId, GroupMembershipsGroupMembershipIdBody payload, string[]? fields) returns GroupMembership|error

Update group membership

Parameters

groupMembershipId string - The ID of the group membership.

payload GroupMembershipsGroupMembershipIdBody -

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

Return Type

GroupMembership|error - Returns a new group membership object.

deleteGroupMembershipsId

Isolated FunctionRemote Function

function deleteGroupMembershipsId(string groupMembershipId) returns Response|error

Remove user from group

Parameters

groupMembershipId string - The ID of the group membership.

Return Type

Response|error - A blank response is returned if the membership was successfully deleted.

getWebhooks

Isolated FunctionRemote Function

function getWebhooks(string? marker, int? 'limit) returns Webhooks|error

List all webhooks

Parameters

marker string? (default ()) - Defines the position marker at which to begin returning results. This is used when paginating using marker-based pagination. This requires usemarker to be set to true.

'limit int? (default ()) - The maximum number of items to return per page.

Return Type

Webhooks|error - Returns a list of webhooks.

postWebhooks

Isolated FunctionRemote Function

function postWebhooks(WebhooksBody payload) returns Webhook|error

Create webhook

Parameters

payload WebhooksBody -

Return Type

Webhook|error - Returns the new webhook object.

getWebhooksId

Isolated FunctionRemote Function

function getWebhooksId(string webhookId) returns Webhook|error

Get webhook

Parameters

webhookId string - The ID of the webhook.

Return Type

Webhook|error - Returns a webhook object

putWebhooksId

Isolated FunctionRemote Function

function putWebhooksId(string webhookId, WebhooksWebhookIdBody payload) returns Webhook|error

Update webhook

Parameters

webhookId string - The ID of the webhook.

payload WebhooksWebhookIdBody -

Return Type

Webhook|error - Returns the new webhook object.

deleteWebhooksId

Isolated FunctionRemote Function

function deleteWebhooksId(string webhookId) returns Response|error

Remove webhook

Parameters

webhookId string - The ID of the webhook.

Return Type

Response|error - An empty response will be returned when the webhook was successfully deleted.

putSkillInvocationsId

Isolated FunctionRemote Function

function putSkillInvocationsId(string skillId, SkillInvocationsSkillIdBody payload) returns Response|error

Update all Box Skill cards on file

Parameters

skillId string - The ID of the skill to apply this metadata for.

payload SkillInvocationsSkillIdBody -

Return Type

Response|error - Returns an empty response when the card has been successfully updated.

getEvents

Isolated FunctionRemote Function

function getEvents(string streamType, string? streamPosition, int 'limit, string[]? eventType, string? createdAfter, string? createdBefore) returns Events|error

List user and enterprise events

Parameters

streamType string (default "all") - Defines the type of events that are returned * all returns everything for a user and is the default * changes returns events that may cause file tree changes such as file updates or collaborations. * sync is similar to changes but only applies to synced folders * admin_logs returns all events for an entire enterprise and requires the user making the API call to have admin permissions.

streamPosition string? (default ()) - The location in the event stream to start receiving events from. * now will return an empty list events and the latest stream position for initialization. * 0 or null will return all events.

'limit int (default 100) - Limits the number of events returned

eventType string[]? (default ()) - A comma-separated list of events to filter by. This can only be used when requesting the events with a stream_type of admin_logs. For any other stream_type this value will be ignored.

createdAfter string? (default ()) - The lower bound date and time to return events for. This can only be used when requesting the events with a stream_type of admin_logs. For any other stream_type this value will be ignored.

createdBefore string? (default ()) - The upper bound date and time to return events for. This can only be used when requesting the events with a stream_type of admin_logs. For any other stream_type this value will be ignored.

Return Type

Events|error - Returns a list of event objects. Events objects are returned in pages, with each page (chunk) including a list of event objects. The response includes a chunk_size parameter indicating how many events were returned in this chunk, as well as the next stream_position that can be queried.

optionsEvents

Isolated FunctionRemote Function

function optionsEvents() returns RealtimeServers|error

Get events long poll endpoint

Return Type

RealtimeServers|error - Returns a paginated array of servers that can be used instead of the regular endpoints for long-polling events.

getCollections

Isolated FunctionRemote Function

function getCollections(string[]? fields, int offset, int? 'limit) returns Collections|error

List all collections

Parameters

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

offset int (default 0) - The offset of the item at which to begin the response.

'limit int? (default ()) - The maximum number of items to return per page.

Return Type

Collections|error - Returns all collections for the given user

getCollectionsIdItems

Isolated FunctionRemote Function

function getCollectionsIdItems(string collectionId, string[]? fields, int offset, int? 'limit) returns Items|error

List collection items

Parameters

collectionId string - The ID of the collection.

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

offset int (default 0) - The offset of the item at which to begin the response.

'limit int? (default ()) - The maximum number of items to return per page.

Return Type

Items|error - Returns an array of items in the collection.

getRecentItems

Isolated FunctionRemote Function

function getRecentItems(string[]? fields, int? 'limit, string? marker) returns RecentItems|error

List recently accessed items

Parameters

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

'limit int? (default ()) - The maximum number of items to return per page.

marker string? (default ()) - Defines the position marker at which to begin returning results. This is used when paginating using marker-based pagination. This requires usemarker to be set to true.

Return Type

RecentItems|error - Returns a list recent items access by a user.

getRetentionPolicies

Isolated FunctionRemote Function

function getRetentionPolicies(string? policyName, string? policyType, string? createdByUserId) returns RetentionPolicies|error

List retention policies

Parameters

policyName string? (default ()) - Filters results by a case sensitive prefix of the name of retention policies.

policyType string? (default ()) - Filters results by the type of retention policy.

createdByUserId string? (default ()) - Filters results by the ID of the user who created policy.

Return Type

RetentionPolicies|error - Returns a list retention policies in the enterprise.

postRetentionPolicies

Isolated FunctionRemote Function

function postRetentionPolicies(RetentionPoliciesBody payload) returns RetentionPolicy|error

Create retention policy

Parameters

payload RetentionPoliciesBody -

Return Type

RetentionPolicy|error - Returns a new retention policy object.

getRetentionPoliciesId

Isolated FunctionRemote Function

function getRetentionPoliciesId(string retentionPolicyId) returns RetentionPolicy|error

Get retention policy

Parameters

retentionPolicyId string - The ID of the retention policy.

Return Type

RetentionPolicy|error - Returns the retention policy object.

putRetentionPoliciesId

Isolated FunctionRemote Function

function putRetentionPoliciesId(string retentionPolicyId, RetentionPoliciesRetentionPolicyIdBody payload) returns RetentionPolicy|error

Update retention policy

Parameters

retentionPolicyId string - The ID of the retention policy.

payload RetentionPoliciesRetentionPolicyIdBody -

Return Type

RetentionPolicy|error - Returns the updated retention policy object.

getRetentionPoliciesIdAssignments

Isolated FunctionRemote Function

function getRetentionPoliciesIdAssignments(string retentionPolicyId, string? 'type, string? marker, int? 'limit) returns RetentionPolicyAssignments|error

List retention policy assignments

Parameters

retentionPolicyId string - The ID of the retention policy.

'type string? (default ()) - The type of the retention policy assignment to retrieve.

marker string? (default ()) - Defines the position marker at which to begin returning results. This is used when paginating using marker-based pagination. This requires usemarker to be set to true.

'limit int? (default ()) - The maximum number of items to return per page.

Return Type

RetentionPolicyAssignments|error - Returns a list of the retention policy assignments associated with the specified retention policy.

postRetentionPolicyAssignments

Isolated FunctionRemote Function

function postRetentionPolicyAssignments(RetentionPolicyAssignmentsBody payload) returns RetentionPolicyAssignment|error

Assign retention policy

Parameters

payload RetentionPolicyAssignmentsBody -

Return Type

RetentionPolicyAssignment|error - Returns a new retention policy assignment object.

getRetentionPolicyAssignmentsId

Isolated FunctionRemote Function

function getRetentionPolicyAssignmentsId(string retentionPolicyAssignmentId) returns RetentionPolicyAssignment|error

Get retention policy assignment

Parameters

retentionPolicyAssignmentId string - The ID of the retention policy assignment.

Return Type

RetentionPolicyAssignment|error - Returns the retention policy assignment object.

getLegalHoldPolicies

Isolated FunctionRemote Function

function getLegalHoldPolicies(string? policyName, string[]? fields, string? marker, int? 'limit) returns LegalHoldPolicies|error

List all legal hold policies

Parameters

policyName string? (default ()) - Limits results to policies for which the names start with this search term. This is a case-insensitive prefix.

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

marker string? (default ()) - Defines the position marker at which to begin returning results. This is used when paginating using marker-based pagination. This requires usemarker to be set to true.

'limit int? (default ()) - The maximum number of items to return per page.

Return Type

LegalHoldPolicies|error - Returns a list of legal hold policies.

postLegalHoldPolicies

Isolated FunctionRemote Function

function postLegalHoldPolicies(LegalHoldPoliciesBody payload) returns LegalHoldPolicy|error

Create legal hold policy

Parameters

payload LegalHoldPoliciesBody -

Return Type

LegalHoldPolicy|error - Returns a new legal hold policy object.

getLegalHoldPoliciesId

Isolated FunctionRemote Function

function getLegalHoldPoliciesId(string legalHoldPolicyId) returns LegalHoldPolicy|error

Get legal hold policy

Parameters

legalHoldPolicyId string - The ID of the legal hold policy

Return Type

LegalHoldPolicy|error - Returns a legal hold policy object.

putLegalHoldPoliciesId

Isolated FunctionRemote Function

function putLegalHoldPoliciesId(string legalHoldPolicyId, LegalHoldPoliciesLegalHoldPolicyIdBody payload) returns LegalHoldPolicy|error

Update legal hold policy

Parameters

legalHoldPolicyId string - The ID of the legal hold policy

payload LegalHoldPoliciesLegalHoldPolicyIdBody -

Return Type

LegalHoldPolicy|error - Returns a new legal hold policy object.

deleteLegalHoldPoliciesId

Isolated FunctionRemote Function

function deleteLegalHoldPoliciesId(string legalHoldPolicyId) returns Response|error

Remove legal hold policy

Parameters

legalHoldPolicyId string - The ID of the legal hold policy

Return Type

Response|error - A blank response is returned if the policy was successfully deleted.

getLegalHoldPolicyAssignments

Isolated FunctionRemote Function

function getLegalHoldPolicyAssignments(string policyId, string? assignToType, string? assignToId, string? marker, int? 'limit, string[]? fields) returns LegalHoldPolicyAssignments|error

List legal hold policy assignments

Parameters

policyId string - The ID of the legal hold policy

assignToType string? (default ()) - Filters the results by the type of item the policy was applied to.

assignToId string? (default ()) - Filters the results by the ID of item the policy was applied to.

marker string? (default ()) - Defines the position marker at which to begin returning results. This is used when paginating using marker-based pagination. This requires usemarker to be set to true.

'limit int? (default ()) - The maximum number of items to return per page.

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

Return Type

LegalHoldPolicyAssignments|error - Returns a list of legal hold policy assignments.

postLegalHoldPolicyAssignments

Isolated FunctionRemote Function

function postLegalHoldPolicyAssignments(LegalHoldPolicyAssignmentsBody payload) returns LegalHoldPolicyAssignment|error

Assign legal hold policy

Parameters

payload LegalHoldPolicyAssignmentsBody -

Return Type

LegalHoldPolicyAssignment|error - Returns a new legal hold policy assignment.

getLegalHoldPolicyAssignmentsId

Isolated FunctionRemote Function

function getLegalHoldPolicyAssignmentsId(string legalHoldPolicyAssignmentId) returns LegalHoldPolicyAssignment|error

Get legal hold policy assignment

Parameters

legalHoldPolicyAssignmentId string - The ID of the legal hold policy assignment

Return Type

LegalHoldPolicyAssignment|error - Returns a legal hold policy object.

deleteLegalHoldPolicyAssignmentsId

Isolated FunctionRemote Function

function deleteLegalHoldPolicyAssignmentsId(string legalHoldPolicyAssignmentId) returns Response|error

Unassign legal hold policy

Parameters

legalHoldPolicyAssignmentId string - The ID of the legal hold policy assignment

Return Type

Response|error - A blank response is returned if the assignment was successfully deleted.

getLegalHoldPolicyAssignmentsIdFilesOnHold

Isolated FunctionRemote Function

function getLegalHoldPolicyAssignmentsIdFilesOnHold(string legalHoldPolicyAssignmentId, string? marker, int? 'limit, string[]? fields) returns FileVersionLegalHolds|error

List current file versions for legal hold policy assignment

Parameters

legalHoldPolicyAssignmentId string - The ID of the legal hold policy assignment

marker string? (default ()) - Defines the position marker at which to begin returning results. This is used when paginating using marker-based pagination. This requires usemarker to be set to true.

'limit int? (default ()) - The maximum number of items to return per page.

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

Return Type

FileVersionLegalHolds|error - Returns the list of current file versions held under legal hold for a specific legal hold policy assignment.

getLegalHoldPolicyAssignmentsIdFileVersionsOnHold

Isolated FunctionRemote Function

function getLegalHoldPolicyAssignmentsIdFileVersionsOnHold(string legalHoldPolicyAssignmentId, string? marker, int? 'limit, string[]? fields) returns FileVersionLegalHolds|error

List previous file versions for legal hold policy assignment

Parameters

legalHoldPolicyAssignmentId string - The ID of the legal hold policy assignment

marker string? (default ()) - Defines the position marker at which to begin returning results. This is used when paginating using marker-based pagination. This requires usemarker to be set to true.

'limit int? (default ()) - The maximum number of items to return per page.

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

Return Type

FileVersionLegalHolds|error - Returns the list of previous file versions held under legal hold for a specific legal hold policy assignment.

getFileVersionRetentionsId

Isolated FunctionRemote Function

function getFileVersionRetentionsId(string fileVersionRetentionId) returns FileVersionRetention|error

Get retention on file

Parameters

fileVersionRetentionId string - The ID of the file version retention

Return Type

FileVersionRetention|error - Returns a file version retention object.

getFileVersionRetentions

Isolated FunctionRemote Function

function getFileVersionRetentions(string? fileId, string? fileVersionId, string? policyId, string? dispositionAction, string? dispositionBefore, string? dispositionAfter, int? 'limit, string? marker) returns FileVersionRetentions|error

List file version retentions

Parameters

fileId string? (default ()) - Filters results by files with this ID.

fileVersionId string? (default ()) - Filters results by file versions with this ID.

policyId string? (default ()) - Filters results by the retention policy with this ID.

dispositionAction string? (default ()) - Filters results by the retention policy with this disposition action.

dispositionBefore string? (default ()) - Filters results by files that will have their disposition come into effect before this date.

dispositionAfter string? (default ()) - Filters results by files that will have their disposition come into effect after this date.

'limit int? (default ()) - The maximum number of items to return per page.

marker string? (default ()) - Defines the position marker at which to begin returning results. This is used when paginating using marker-based pagination. This requires usemarker to be set to true.

Return Type

FileVersionRetentions|error - Returns a list of all file version retentions for the enterprise.

getFileVersionLegalHoldsId

Isolated FunctionRemote Function

function getFileVersionLegalHoldsId(string fileVersionLegalHoldId) returns FileVersionLegalHold|error

Get file version legal hold

Parameters

fileVersionLegalHoldId string - The ID of the file version legal hold

Return Type

FileVersionLegalHold|error - Returns the legal hold policy assignments for the file version.

getFileVersionLegalHolds

Isolated FunctionRemote Function

function getFileVersionLegalHolds(string policyId, string? marker, int? 'limit) returns FileVersionLegalHolds|error

List file version legal holds

Parameters

policyId string - The ID of the legal hold policy to get the file version legal holds for.

marker string? (default ()) - Defines the position marker at which to begin returning results. This is used when paginating using marker-based pagination. This requires usemarker to be set to true.

'limit int? (default ()) - The maximum number of items to return per page.

Return Type

FileVersionLegalHolds|error - Returns the list of file version legal holds for a specific legal hold policy.

getDevicePinnersId

Isolated FunctionRemote Function

function getDevicePinnersId(string devicePinnerId) returns DevicePinner|error

Get device pin

Parameters

devicePinnerId string - The ID of the device pin

Return Type

DevicePinner|error - Returns information about a single device pin.

deleteDevicePinnersId

Isolated FunctionRemote Function

function deleteDevicePinnersId(string devicePinnerId) returns Response|error

Remove device pin

Parameters

devicePinnerId string - The ID of the device pin

Return Type

Response|error - Returns an empty response when the pin has been deleted.

getEnterprisesIdDevicePinners

Isolated FunctionRemote Function

function getEnterprisesIdDevicePinners(string enterpriseId, string? marker, int? 'limit, string? direction) returns DevicePinners|error

List enterprise device pins

Parameters

enterpriseId string - The ID of the enterprise

marker string? (default ()) - Defines the position marker at which to begin returning results. This is used when paginating using marker-based pagination. This requires usemarker to be set to true.

'limit int? (default ()) - The maximum number of items to return per page.

direction string? (default ()) - The direction to sort results in. This can be either in alphabetical ascending (ASC) or descending (DESC) order.

Return Type

DevicePinners|error - Returns a list of device pins for a given enterprise.

getTermsOfServices

Isolated FunctionRemote Function

function getTermsOfServices(string? tosType) returns TermsOfServices|error

List terms of services

Parameters

tosType string? (default ()) - Limits the results to the terms of service of the given type.

Return Type

TermsOfServices|error - Returns a collection of terms of service text and settings for the enterprise.

postTermsOfServices

Isolated FunctionRemote Function

function postTermsOfServices(TermsOfServicesBody payload) returns Task|error

Create terms of service

Parameters

payload TermsOfServicesBody -

Return Type

Task|error - Returns a new task object

getTermsOfServicesId

Isolated FunctionRemote Function

function getTermsOfServicesId(string termsOfServiceId) returns TermsOfService|error

Get terms of service

Parameters

termsOfServiceId string - The ID of the terms of service.

Return Type

TermsOfService|error - Returns a terms of service object.

putTermsOfServicesId

Isolated FunctionRemote Function

function putTermsOfServicesId(string termsOfServiceId, TermsOfServicesTermsOfServiceIdBody payload) returns TermsOfService|error

Update terms of service

Parameters

termsOfServiceId string - The ID of the terms of service.

payload TermsOfServicesTermsOfServiceIdBody -

Return Type

TermsOfService|error - Returns an updated terms of service object.

getTermsOfServiceUserStatuses

Isolated FunctionRemote Function

function getTermsOfServiceUserStatuses(string tosId, string? userId) returns TermsOfServiceUserStatuses|error

List terms of service user statuses

Parameters

tosId string - The ID of the terms of service.

userId string? (default ()) - Limits results to the given user ID.

Return Type

TermsOfServiceUserStatuses|error - Returns a list of terms of service statuses.

postTermsOfServiceUserStatuses

Isolated FunctionRemote Function

function postTermsOfServiceUserStatuses(TermsOfServiceUserStatusesBody payload) returns TermsOfServiceUserStatus|error

Create terms of service status for new user

Parameters

payload TermsOfServiceUserStatusesBody -

Return Type

TermsOfServiceUserStatus|error - Returns a terms of service status object.

putTermsOfServiceUserStatusesId

Isolated FunctionRemote Function

function putTermsOfServiceUserStatusesId(string termsOfServiceUserStatusId, TermsOfServiceUserStatusesTermsOfServiceUserStatusIdBody payload) returns TermsOfServiceUserStatus|error

Update terms of service status for existing user

Parameters

termsOfServiceUserStatusId string - The ID of the terms of service status.

payload TermsOfServiceUserStatusesTermsOfServiceUserStatusIdBody -

Return Type

TermsOfServiceUserStatus|error - Returns the updated terms of service status object.

getCollaborationWhitelistEntries

Isolated FunctionRemote Function

function getCollaborationWhitelistEntries(string? marker, int? 'limit) returns CollaborationAllowlistEntries|error

List allowed collaboration domains

Parameters

marker string? (default ()) - Defines the position marker at which to begin returning results. This is used when paginating using marker-based pagination. This requires usemarker to be set to true.

'limit int? (default ()) - The maximum number of items to return per page.

Return Type

CollaborationAllowlistEntries|error - Returns a collection of domains that are allowed for collaboration.

postCollaborationWhitelistEntries

Isolated FunctionRemote Function

function postCollaborationWhitelistEntries(CollaborationWhitelistEntriesBody payload) returns CollaborationAllowlistEntry|error

Add domain to list of allowed collaboration domains

Parameters

payload CollaborationWhitelistEntriesBody -

Return Type

CollaborationAllowlistEntry|error - Returns a new entry on the list of allowed domains.

getCollaborationWhitelistEntriesId

Isolated FunctionRemote Function

function getCollaborationWhitelistEntriesId(string collaborationWhitelistEntryId) returns CollaborationAllowlistEntry|error

Get allowed collaboration domain

Parameters

collaborationWhitelistEntryId string - The ID of the entry in the list.

Return Type

CollaborationAllowlistEntry|error - Returns an entry on the list of allowed domains.

deleteCollaborationWhitelistEntriesId

Isolated FunctionRemote Function

function deleteCollaborationWhitelistEntriesId(string collaborationWhitelistEntryId) returns Response|error

Remove domain from list of allowed collaboration domains

Parameters

collaborationWhitelistEntryId string - The ID of the entry in the list.

Return Type

Response|error - A blank response is returned if the entry was successfully deleted.

getCollaborationWhitelistExemptTargets

Isolated FunctionRemote Function

function getCollaborationWhitelistExemptTargets(string? marker, int? 'limit) returns CollaborationAllowlistExemptTargets|error

List users exempt from collaboration domain restrictions

Parameters

marker string? (default ()) - Defines the position marker at which to begin returning results. This is used when paginating using marker-based pagination. This requires usemarker to be set to true.

'limit int? (default ()) - The maximum number of items to return per page.

Return Type

CollaborationAllowlistExemptTargets|error - Returns a collection of user exemptions.

postCollaborationWhitelistExemptTargets

Isolated FunctionRemote Function

function postCollaborationWhitelistExemptTargets(CollaborationWhitelistExemptTargetsBody payload) returns CollaborationAllowlistExemptTarget|error

Create user exemption from collaboration domain restrictions

Parameters

payload CollaborationWhitelistExemptTargetsBody -

Return Type

CollaborationAllowlistExemptTarget|error - Returns a new exemption entry.

getCollaborationWhitelistExemptTargetsId

Isolated FunctionRemote Function

function getCollaborationWhitelistExemptTargetsId(string collaborationWhitelistExemptTargetId) returns CollaborationAllowlistExemptTarget|error

Get user exempt from collaboration domain restrictions

Parameters

collaborationWhitelistExemptTargetId string - The ID of the exemption to the list.

Return Type

CollaborationAllowlistExemptTarget|error - Returns the user's exempted from the list of collaboration domains.

deleteCollaborationWhitelistExemptTargetsId

Isolated FunctionRemote Function

function deleteCollaborationWhitelistExemptTargetsId(string collaborationWhitelistExemptTargetId) returns Response|error

Remove user from list of users exempt from domain restrictions

Parameters

collaborationWhitelistExemptTargetId string - The ID of the exemption to the list.

Return Type

Response|error - A blank response is returned if the exemption was successfully deleted.

getStoragePolicies

Isolated FunctionRemote Function

function getStoragePolicies(string[]? fields, string? marker, int? 'limit) returns StoragePolicies|error

List storage policies

Parameters

fields string[]? (default ()) - A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

marker string? (default ()) - Defines the position marker at which to begin returning results. This is used when paginating using marker-based pagination. This requires usemarker to be set to true.

'limit int? (default ()) - The maximum number of items to return per page.

Return Type

StoragePolicies|error - Returns a collection of storage policies.

getStoragePoliciesId

Isolated FunctionRemote Function

function getStoragePoliciesId(string storagePolicyId) returns StoragePolicy|error

Get storage policy

Parameters

storagePolicyId string - The ID of the storage policy.

Return Type

StoragePolicy|error - Returns a storage policy object.

getStoragePolicyAssignments

Isolated FunctionRemote Function

function getStoragePolicyAssignments(string resolvedForType, string resolvedForId, string? marker) returns StoragePolicyAssignments|error

List storage policy assignments

Parameters

resolvedForType string - The target type to return assignments for

resolvedForId string - The ID of the user or enterprise to return assignments for

marker string? (default ()) - Defines the position marker at which to begin returning results. This is used when paginating using marker-based pagination. This requires usemarker to be set to true.

Return Type

StoragePolicyAssignments|error - Returns a collection of storage policies for the enterprise or user.

postStoragePolicyAssignments

Isolated FunctionRemote Function

function postStoragePolicyAssignments(StoragePolicyAssignmentsBody payload) returns StoragePolicyAssignment|error

Assign storage policy

Parameters

payload StoragePolicyAssignmentsBody -

Return Type

StoragePolicyAssignment|error - Returns the new storage policy assignment created.

getStoragePolicyAssignmentsId

Isolated FunctionRemote Function

function getStoragePolicyAssignmentsId(string storagePolicyAssignmentId) returns StoragePolicyAssignment|error

Get storage policy assignment

Parameters

storagePolicyAssignmentId string - The ID of the storage policy assignment.

Return Type

StoragePolicyAssignment|error - Returns a storage policy assignment object.

putStoragePolicyAssignmentsId

Isolated FunctionRemote Function

function putStoragePolicyAssignmentsId(string storagePolicyAssignmentId, StoragePolicyAssignmentsStoragePolicyAssignmentIdBody payload) returns StoragePolicyAssignment|error

Update storage policy assignment

Parameters

storagePolicyAssignmentId string - The ID of the storage policy assignment.

payload StoragePolicyAssignmentsStoragePolicyAssignmentIdBody -

Return Type

StoragePolicyAssignment|error - Returns an updated storage policy assignment object.

deleteStoragePolicyAssignmentsId

Isolated FunctionRemote Function

function deleteStoragePolicyAssignmentsId(string storagePolicyAssignmentId) returns Response|error

Unassign storage policy

Parameters

storagePolicyAssignmentId string - The ID of the storage policy assignment.

Return Type

Response|error - Returns an empty response when the storage policy assignment is successfully deleted.

postZipDownloads

Isolated FunctionRemote Function

function postZipDownloads(ZipDownloadRequest payload) returns ZipDownload|error

Create zip download

Parameters

payload ZipDownloadRequest -

Return Type

ZipDownload|error - If the zip archive is ready to be downloaded, the API will return a response that will include a download_url, a status_url, as well as any conflicts that might have occurred when creating the request.

getZipDownloadsIdContent

Isolated FunctionRemote Function

function getZipDownloadsIdContent(string zipDownloadId) returns string|error

Download zip archive

Parameters

zipDownloadId string - The unique identifier that represent this zip archive.

Return Type

string|error - Returns the content of the items requested for this download, formatted as a stream of files and folders in a zip archive.

getZipDownloadsIdStatus

Isolated FunctionRemote Function

function getZipDownloadsIdStatus(string zipDownloadId) returns ZipDownloadStatus|error

Get zip download status

Parameters

zipDownloadId string - The unique identifier that represent this zip archive.

Return Type

ZipDownloadStatus|error - Returns the status of the zip archive that is being downloaded.

Records

box: AccessToken

A token that can be used to make authenticated API calls.

Fields

access_token string? - The requested access token.

expires_in int? - The time in seconds in seconds by which this token will expire.

token_type string? - The type of access token returned.

restricted_to FileScope[]? - The permissions that this access token permits, providing a list of resources (files, folders, etc) and the scopes permitted for each of those resources.

refresh_token string? - The refresh token for this access token, which can be used to request a new access token when the current one expires.

issued_token_type string? - The type of downscoped access token returned. This is only returned if an access token has been downscoped.

box: AssignedTo

The bare basic reference for an object

Fields

id string? - The unique identifier for this object

'type string? - The type for this object

box: ClassificationTemplate

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

Fields

id string? - The ID of the classification template.

'type string? - metadata_template

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

templateKey string? - securityClassification-6VMVochwUWo

displayName string? - The name of this template as shown in web and mobile interfaces.

hidden boolean? - This template is always available in web and mobile interfaces.

copyInstanceOnItemCopy boolean? - Classifications are always copied along when the file or folder is copied.

fields ClassificationtemplateFields[]? - 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.

box: ClassificationtemplateFields

The metadata template field that represents the available classifications.

Fields

id string? - The unique ID of the field.

'type string? - enum

'key string? - Box__Security__Classification__Key

displayName string? - Classification

hidden boolean? - Classifications are always visible to web and mobile users.

options ClassificationtemplateOptions[]? - A list of classifications available in this enterprise.

box: ClassificationtemplateOptions

A single classification available in this enterprise.

Fields

id string? - The unique ID of this classification.

'key string? - The display name and key for this classification.

staticConfig ClassificationtemplateStaticconfig? - Additional information about the classification.

box: ClassificationtemplateStaticconfig

Additional information about the classification.

Fields

classification ClassificationtemplateStaticconfigClassification? - Additional information about the classification. This is not an exclusive list of properties, and more object fields might be returned. These fields are used for internal Box Shield and Box Governance purposes and no additional value must be derived from these fields.

box: ClassificationtemplateStaticconfigClassification

Additional information about the classification. This is not an exclusive list of properties, and more object fields might be returned. These fields are used for internal Box Shield and Box Governance purposes and no additional value must be derived from these fields.

Fields

classificationDefinition string? - A longer description of the classification.

colorID decimal? - An internal Box identifier used to assign a color to a classification label. Mapping between a colorID and a color may change without notice. Currently, the color mappings are as follows. * 0: Yellow * 1: Orange * 2: Watermelon red * 3: Purple rain * 4: Light blue * 5: Dark blue * 6: Light green * 7: Gray

box: ClientError

A generic error

Fields

'type string? - error

status int? - The HTTP status of the response.

code string? - A Box-specific error code

message string? - A short message describing the error.

context_info ClienterrorContextInfo? - A free-form object that contains additional context about the error. The possible fields are defined on a per-endpoint basis.

help_url string? - A URL that links to more information about why this error occurred.

request_id string? - A unique identifier for this response, which can be used when contacting Box support.

box: ClienterrorContextInfo

A free-form object that contains additional context about the error. The possible fields are defined on a per-endpoint basis.

Fields

conflicts FileConflict[]? - A list of the file conflicts that caused this error.

box: ClientHttp1Settings

Closed record

Provides settings related to HTTP/1.x protocol.

Fields

keepAlive KeepAlive(default http:KEEPALIVE_AUTO) - Specifies whether to reuse a connection for multiple requests

chunking Chunking(default http:CHUNKING_AUTO) - The chunking behaviour of the request

proxy ProxyConfig? - Proxy server related options

box: Collaboration

Collaborations define access permissions for users and groups to files and folders, similar to access control lists. A collaboration object grants a user or group access to a file or folder with permissions defined by a specific role.

Fields

id string? - The unique identifier for this collaboration.

'type string? - collaboration

item File|Folder|WebLink?? -

accessible_by UserMini? - A mini representation of a user, as can be returned when nested within other resources.

invite_email string? - The email address used to invite an unregistered collaborator, if they are not a registered user.

role string? - The level of access granted.

expires_at string? - When the collaboration will expire, or null if no expiration date is set.

status string? - The status of the collaboration invitation.

acknowledged_at string? - When the status of the collaboration object changed to accepted or rejected

created_by UserMini? - A mini representation of a user, as can be returned when nested within other resources.

created_at string? - When the collaboration object was created

modified_at string? - When the collaboration object was last modified

acceptance_requirements_status CollaborationAcceptanceRequirementsStatus? - The terms of service that must be accepted before the collaboration can be accepted.

box: CollaborationAcceptanceRequirementsStatus

The terms of service that must be accepted before the collaboration can be accepted.

Fields

terms_of_service_requirement CollaborationAcceptanceRequirementsStatusTermsOfServiceRequirement? -

strong_password_requirement CollaborationAcceptanceRequirementsStatusStrongPasswordRequirement? -

two_factor_authentication_requirement CollaborationAcceptanceRequirementsStatusTwoFactorAuthenticationRequirement? -

box: CollaborationAcceptanceRequirementsStatusStrongPasswordRequirement

Fields

enterprise_has_strong_password_required_for_external_users boolean? - Whether or not the enterprise that owns the content requires a strong password to collaborate on the content.

user_has_strong_password boolean? - Whether or not the user has a strong password set for their account. The field is null when a strong password is not required.

box: CollaborationAcceptanceRequirementsStatusTermsOfServiceRequirement

Fields

is_accepted boolean? - Whether or not the terms of service have been accepted. The field is null when there is no terms of service required.

terms_of_service record {}? -

box: CollaborationAcceptanceRequirementsStatusTwoFactorAuthenticationRequirement

Fields

enterprise_has_two_factor_auth_enabled boolean? - Whether or not the enterprise that owns the content requires two-factor authentication to be enabled in order to collaborate on the content.

user_has_two_factor_authentication_enabled boolean? - Whether or not the user has two-factor authentication enabled. The field is null when two-factor authentication is not required.

box: CollaborationAllowlistEnterprise

A representation of a Box enterprise

Fields

id string? - The unique identifier for this enterprise.

'type string? - enterprise

name string? - The name of the enterprise

box: CollaborationAllowlistEntries

A list of allowed domains for collaboration.

Fields

'limit int? - The limit that was used for these entries. This will be the same as the limit query parameter unless that value exceeded the maximum value allowed. The maximum value varies by API.

next_marker int? - The marker for the start of the next page of results.

prev_marker int? - The marker for the start of the previous page of results.

entries CollaborationAllowlistEntry[]? -

box: CollaborationAllowlistEntry

An entry that describes an approved domain for which users can collaborate with files and folders in your enterprise or vice versa.

Fields

id string? - The unique identifier for this entry

'type string? - collaboration_whitelist_entry

domain string? - The whitelisted domain

direction string? - The direction of the collaborations to allow.

enterprise CollaborationAllowlistEnterprise? - A representation of a Box enterprise

created_at string? - The time the entry was created at

box: CollaborationAllowlistExemptTarget

The user that is exempt from any of the restrictions imposed by the list of allowed collaboration domains for this enterprise.

Fields

id string? - The unique identifier for this exemption

'type string? - collaboration_whitelist

enterprise CollaborationAllowlistEnterprise? - A representation of a Box enterprise

user CollaborationAllowlistUser? - A representation of a Box enterprise

created_at string? - The time the entry was created

modified_at string? - The time the entry was modified

box: CollaborationAllowlistExemptTargets

A list of users that is exempt from any of the restrictions imposed by the list of allowed collaboration domains for this enterprise.

Fields

'limit int? - The limit that was used for these entries. This will be the same as the limit query parameter unless that value exceeded the maximum value allowed. The maximum value varies by API.

next_marker int? - The marker for the start of the next page of results.

prev_marker int? - The marker for the start of the previous page of results.

entries CollaborationAllowlistExemptTarget[]? -

box: CollaborationAllowlistUser

A representation of a Box enterprise

Fields

id string? - The unique identifier for this enterprise.

'type string? - enterprise

name string? - The name of the enterprise

box: Collaborations

A list of collaborations

Fields

total_count int? - One greater than the offset of the last entry in the entire collection. The total number of entries in the collection may be less than total_count. This field is only returned for calls that use offset-based pagination. For marker-based paginated APIs, this field will be omitted.

'limit int? - The limit that was used for these entries. This will be the same as the limit query parameter unless that value exceeded the maximum value allowed. The maximum value varies by API.

offset int? - The 0-based offset of the first entry in this set. This will be the same as the offset query parameter. This field is only returned for calls that use offset-based pagination. For marker-based paginated APIs, this field will be omitted.

'order CollaborationsOrder[]? - The order by which items are returned. This field is only returned for calls that use offset-based pagination. For marker-based paginated APIs, this field will be omitted.

entries Collaboration[]? -

box: CollaborationsAccessibleBy

The user or group to give access to the item.

Fields

'type string - The type of collaborator to invite.

id string? - The ID of the user or group. Alternatively, use login to specify a user by email address.

box: CollaborationsBody

Fields

item CollaborationsItem - The item to attach the comment to.

accessible_by CollaborationsAccessibleBy - The user or group to give access to the item.

role string - The level of access granted.

can_view_path boolean? - Determines if the invited users can see the entire parent path to the associated folder. The user will not gain privileges in any parent folder and therefore can not see content the user is not collaborated on. Be aware that this meaningfully increases the time required to load the invitee's All Files page. We recommend you limit the number of collaborations with can_view_path enabled to 1,000 per user.

expires_at string? - Set the expiration date for the collaboration. At this date, the collaboration will be automatically removed from the item. This feature will only work if the Automatically remove invited collaborators: Allow folder owners to extend the expiry date setting has been enabled in the Enterprise Settings of the Admin Console. When the setting is not enabled, collaborations can not have an expiry date and a value for this field will be result in an error.

box: CollaborationsCollaborationIdBody

Fields

role string - The level of access granted.

status string? -  Set the status of a `pending` collaboration invitation, effectively accepting, or rejecting the invite.

expires_at string? - Update the expiration date for the collaboration. At this date, the collaboration will be automatically removed from the item. This feature will only work if the Automatically remove invited collaborators: Allow folder owners to extend the expiry date setting has been enabled in the Enterprise Settings of the Admin Console. When the setting is not enabled, collaborations can not have an expiry date and a value for this field will be result in an error. Additionally, a collaboration can only be given an expiration if it was created after the Automatically remove invited collaborator setting was enabled.

can_view_path boolean? - Determines if the invited users can see the entire parent path to the associated folder. The user will not gain privileges in any parent folder and therefore can not see content the user is not collaborated on. Be aware that this meaningfully increases the time required to load the invitee's All Files page. We recommend you limit the number of collaborations with can_view_path enabled to 1,000 per user.

box: CollaborationsItem

The item to attach the comment to.

Fields

'type string - The type of the item that this collaboration will be granted access to

id string - The ID of the item that will be granted access to

box: CollaborationsOrder

The order in which a pagination is ordered

Fields

'by string? - The field to order by

direction string? - The direction to order by, either ascending or descending

box: CollaborationWhitelistEntriesBody

Fields

domain string - The domain to add to the list of allowed domains.

direction string - The direction in which to allow collaborations.

box: CollaborationWhitelistExemptTargetsBody

Fields

user CollaborationWhitelistExemptTargetsUser - The user to exempt.

box: CollaborationWhitelistExemptTargetsUser

The user to exempt.

Fields

id string - The ID of the user to exempt.

box: Collection

A collection of items, including files and folders. Currently, the only collection available is the favorites collection. The contents of a collection can be explored in a similar way to which the contents of a folder is explored.

Fields

id string? - The unique identifier for this collection.

'type string? - collection

name string? - The name of the collection.

collection_type string? - The type of the collection. This is used to determine the proper visual treatment for collections.

box: Collections

A list of collections

Fields

total_count int? - One greater than the offset of the last entry in the entire collection. The total number of entries in the collection may be less than total_count. This field is only returned for calls that use offset-based pagination. For marker-based paginated APIs, this field will be omitted.

'limit int? - The limit that was used for these entries. This will be the same as the limit query parameter unless that value exceeded the maximum value allowed. The maximum value varies by API.

offset int? - The 0-based offset of the first entry in this set. This will be the same as the offset query parameter. This field is only returned for calls that use offset-based pagination. For marker-based paginated APIs, this field will be omitted.

'order CollaborationsOrder[]? - The order by which items are returned. This field is only returned for calls that use offset-based pagination. For marker-based paginated APIs, this field will be omitted.

entries Collection[]? -

box: Comment

Standard representation of a comment.

Fields

Fields Included from *CommentBase

id string
type string
anydata...

is_reply_comment boolean? - Whether or not this comment is a reply to another comment

message string? - The text of the comment, as provided by the user

created_by record {}? -

created_at string? - The time this comment was created

modified_at string? - The time this comment was last modified

item record { id string, 'type string }? -

box: CommentBase

Base representation of a comment.

Fields

id string? - The unique identifier for this comment.

'type string? - comment

box: CommentFull

Comments are messages created on files. Comments can be made independently or created as responses to other comments

Fields

Fields Included from *Comment

is_reply_comment boolean
message string
created_by record { name string, login string, id string, type string, anydata... }
created_at string
modified_at string
item record { id string, type string, anydata... }
id string
type string
anydata...

tagged_message string? - The string representing the comment text with @mentions included. @mention format is @[id:username] where id is user's Box ID and username is their display name.

box: Comments

A list of comments

Fields

total_count int? - One greater than the offset of the last entry in the entire collection. The total number of entries in the collection may be less than total_count. This field is only returned for calls that use offset-based pagination. For marker-based paginated APIs, this field will be omitted.

'limit int? - The limit that was used for these entries. This will be the same as the limit query parameter unless that value exceeded the maximum value allowed. The maximum value varies by API.

offset int? - The 0-based offset of the first entry in this set. This will be the same as the offset query parameter. This field is only returned for calls that use offset-based pagination. For marker-based paginated APIs, this field will be omitted.

'order CollaborationsOrder[]? - The order by which items are returned. This field is only returned for calls that use offset-based pagination. For marker-based paginated APIs, this field will be omitted.

entries Comment[]? -

box: CommentsBody

Fields

message string - The text of the comment. To mention a user, use the tagged_message parameter instead.

tagged_message string? - The text of the comment, including @[user_id:name] somewhere in the message to mention another user, which will send them an email notification, letting them know they have been mentioned. The user_id is the target user's ID, where the name can be any custom phrase. In the Box UI this name will link to the user's profile. If you are not mentioning another user, use message instead.

item CommentsItem? - The item to attach the comment to.

box: CommentsCommentIdBody

Fields

message string? - The text of the comment to update

box: CommentsItem

The item to attach the comment to.

Fields

id string - The ID of the item

'type string - The type of the item that this comment will be placed on.

box: ConflictError

The error that occurs when a file can not be created due to a conflict.

Fields

Fields Included from *ClientError

type string
status int
code string
message string
context_info ClienterrorContextInfo
help_url string
request_id string
anydata...

context_info ConflicterrorContextInfo? -

box: ConflicterrorContextInfo

Fields

conflicts FileConflict[]? - A list of the file conflicts that caused this error.

box: ConnectionConfig

Closed record

Provides a set of configurations for controlling the behaviours when communicating with a remote HTTP endpoint.

Fields

auth BearerTokenConfig|OAuth2RefreshTokenGrantConfig - Configurations related to client authentication

httpVersion HttpVersion(default http:HTTP_2_0) - The HTTP version understood by the client

http1Settings ClientHttp1Settings? - Configurations related to HTTP/1.x protocol

http2Settings ClientHttp2Settings? - Configurations related to HTTP/2 protocol

timeout decimal(default 60) - The maximum time to wait (in seconds) for a response before closing the connection

forwarded string(default "disable") - The choice of setting forwarded/x-forwarded header

poolConfig PoolConfiguration? - Configurations associated with request pooling

cache CacheConfig? - HTTP caching related configurations

compression Compression(default http:COMPRESSION_AUTO) - Specifies the way of handling compression (accept-encoding) header

circuitBreaker CircuitBreakerConfig? - Configurations associated with the behaviour of the Circuit Breaker

retryConfig RetryConfig? - Configurations associated with retrying

responseLimits ResponseLimitConfigs? - Configurations associated with inbound response size limits

secureSocket ClientSecureSocket? - SSL/TLS-related options

proxy ProxyConfig? - Proxy server related options

validation boolean(default true) - Enables the inbound payload validation functionality which provided by the constraint package. Enabled by default

box: DevicePinner

Device pins allow enterprises to control what devices can use native Box applications.

Fields

id string? - The unique identifier for this device pin.

'type string? - device_pinner

owned_by UserMini? - A mini representation of a user, as can be returned when nested within other resources.

product_name string? - The type of device being pinned

created_at string? - The time the device pin was created

modified_at string? - The time the device pin was modified

box: DevicePinners

A list of device pins

Fields

entries DevicePinner[]? - A entries of device pins

'limit int? - The limit that was used for these entries. This will be the same as the limit query parameter unless that value exceeded the maximum value allowed.

next_marker int? - The marker for the start of the next page of results.

'order DevicepinnersOrder[]? - The order by which items are returned.

box: DevicepinnersOrder

The order in which a pagination is ordered

Fields

'by string? - The field that is ordered by

direction string? - The direction to order by, either ascending or descending

box: EmailAlias

An email alias for a user.

Fields

id string? - The unique identifier for this object

'type string? - Email alias type

email string? - The email address

is_confirmed boolean? - Whether the email address has been confirmed

box: EmailAliases

A list of email aliases

Fields

total_count int? - The number of email aliases.

entries EmailAlias[]? - The entries of email alias.

box: Enterprise

A representation of a Box enterprise

Fields

id string? - The unique identifier for this enterprise.

'type string? - enterprise

name string? - The name of the enterprise

box: Event

The description of an event that happened within Box

Fields

'type string? - event

event_id string? - The ID of the event object. You can use this to detect duplicate events

created_by UserMini? - A mini representation of a user, as can be returned when nested within other resources.

event_type string? - An event type that can trigger an event

session_id string? - The session of the user that performed the action. Not all events will populate this attribute.

'source User|EventSource? -

additional_details record {}? - This object provides additional information about the event if available. This can include how a user performed an event as well as additional information to correlate an event to external KeySafe logs. Not all events have an additional_details object. This object is only available in the Enterprise Events.

box: Events

A list of event objects

Fields

chunk_size int? - The number of events returned in this response.

next_stream_position string? - The stream position of the start of the next page (chunk) of events.

entries Event[]? - The description of an events that happened within Box.

box: EventSource

The source file or folder that triggered an event in the event stream.

Fields

item_type string? - The type of the item that the event represents. Can be file or folder.

item_id string? - The unique identifier that represents the item.

item_name string? - The name of the item.

parent FolderMini? - A mini representation of a file version, used when nested under another resource.

owned_by UserMini? - A mini representation of a user, as can be returned when nested within other resources.

box: File

A standard representation of a file, as returned from any file API endpoints by default

Fields

Fields Included from *FileMini

sequence_id record { anydata... }
name string
sha1 string
file_version record { sha1 string, id string, type string, anydata... }
id string
etag string|()
type string
anydata...

description string? - The optional description of this file

size int? - The file size in bytes. Be careful parsing this integer as it can get very large and cause an integer overflow.

path_collection record { total_count int, entries FolderMini[] }? -

created_at string? - The date and time when the file was created on Box.

modified_at string? - The date and time when the file was last updated on Box.

trashed_at string? - The time at which this file was put in the trash.

purged_at string? - The time at which this file is expected to be purged from the trash.

content_created_at string? - The date and time at which this file was originally created, which might be before it was uploaded to Box.

content_modified_at string? - The date and time at which this file was last updated, which might be before it was uploaded to Box.

created_by record {}? -

modified_by record {}? -

owned_by record {}? -

shared_link record { url string, download_url string?, vanity_url string?, vanity_name string?, access string, effective_access string, effective_permission string, unshared_at string?, is_password_enabled boolean, permissions record { can_download boolean, can_preview boolean }, download_count int, preview_count int }? -

parent record {}? -

item_status string? - Defines if this item has been deleted or not. * active when the item has is not in the trash * trashed when the item has been moved to the trash but not deleted * deleted when the item has been permanently deleted.

box: FileBase

The bare basic representation of a file, the minimal amount of fields returned when using the fields query parameter.

Fields

id string? - The unique identifier that represent 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.

etag string? - The HTTP etag of this file. This can be used within some API endpoints in the If-Match and If-None-Match headers to only perform changes on the file if (no) changes have happened.

'type string? - file

box: FileConflict

A representation of a file that is used to show

Fields

Fields Included from *FileMini

sequence_id record { anydata... }
name string
sha1 string
file_version record { sha1 string, id string, type string, anydata... }
id string
etag string|()
type string
anydata...

sha1 string? - The SHA1 hash of the file.

file_version FileversionMini? - A mini representation of a file version, used when nested within another resource.

box: FileFull

A full representation of a file, as can be returned from any file API endpoints by default

Fields

Fields Included from *File

description string
size int
path_collection record { total_count int, entries FolderMini[], anydata... }
created_at string
modified_at string
trashed_at string|()
purged_at string|()
content_created_at string|()
content_modified_at string|()
created_by record { name string, login string, id string, type string, anydata... }
modified_by record { name string, login string, id string, type string, anydata... }
owned_by record { name string, login string, id string, type string, anydata... }
shared_link record { url string, download_url string|(), vanity_url string|(), vanity_name string|(), access string, effective_access string, effective_permission string, unshared_at string|(), is_password_enabled boolean, permissions record { can_download boolean, can_preview boolean, anydata... }, download_count int, preview_count int, anydata... }
parent record { sequence_id record { anydata... }, name string, id string, etag string|(), type string, anydata... }
item_status string
sequence_id record { anydata... }
name string
sha1 string
file_version record { sha1 string, id string, type string, anydata... }
id string
etag string|()
type string
anydata...

version_number string? - The version number of this file

comment_count int? - The number of comments on this file

permissions record { can_delete boolean, can_download boolean, can_invite_collaborator boolean, can_rename boolean, can_set_share_access boolean, can_share boolean, can_annotate boolean, can_comment boolean, can_preview boolean, can_upload boolean, can_view_annotations_all boolean, can_view_annotations_self boolean }? -

tags record {}? -

'lock record { id string, 'type string, created_by record {}, created_at string, expired_at string, is_download_prevented boolean }? -

extension string? - Indicates the (optional) file extension for this file. By default, this is set to an empty string.

is_package boolean? - Indicates if the file is a package. Packages are commonly used by Mac Applications and can include iWork files.

expiring_embed_link record { access_token string, expires_in int, token_type string, restricted_to FileScope[], url string }? -

watermark_info record { is_watermarked boolean }? -

allowed_invitee_roles string[]? - A list of the types of roles that user can be invited at when sharing this file.

is_externally_owned boolean? - Specifies if this file is owned by a user outside of the authenticated enterprise.

has_collaborations boolean? - Specifies if this file has any other collaborators.

metadata record {}? -

expires_at string? - When the file will automatically be deleted

representations record { entries record { content record { url_template string }, info record { url string }, properties record { dimensions string, paged boolean, thumb boolean }, representation string, status record { state string } }[] }? -

classification record { name string, definition string, color string }? -

uploader_display_name record {}? -

box: FileIdContentBody

Fields

attributes FilesfileIdcontentAttributes - The additional attributes of the file being uploaded. Mainly the name and the parent folder. These attributes are part of the multi part request body and are in JSON format. <Message warning> The attributes part of the body must come before the file part. Requests that do not follow this format when uploading the file will receive a HTTP 400 error with a metadata_after_file_contents error code. </Message>

file string - The content of the file to upload to Box. <Message warning> The attributes part of the body must come before the file part. Requests that do not follow this format when uploading the file will receive a HTTP 400 error with a metadata_after_file_contents error code. </Message>

box: FileIdCopyBody

Fields

name string? - An optional new name for the copied file. There are some restrictions to the file name. Names containing non-printable ASCII characters, forward and backward slashes (/, \), and protected names like . and .. are automatically sanitized by removing the non-allowed characters. MISSING[`]

'version string? - An optional ID of the specific file version to copy.

parent FilesfileIdcopyParent - The destination folder to copy the file to.

box: FileIdUploadSessionsBody

Fields

file_size int - The total number of bytes of the file to be uploaded

file_name string? - The optional new name of new file

box: FileIdWatermarkBody

Fields

watermark FilesfileIdwatermarkWatermark - The watermark to imprint on the file

box: FileMini

A mini representation of a file, used when nested under another resource.

Fields

Fields Included from *FileBase

id string
etag string|()
type string
anydata...

sequence_id record {}? -

name string? - The name of the file

sha1 string? - The SHA1 hash of the file. This can be used to compare the contents of a file on Box with a local file.

file_version record {}? -

box: FileRequest

A standard representation of a file request, as returned from any file request API endpoints by default.

Fields

id string? - The unique identifier for this file request.

'type string? - file-request

title string? - The title of file request. This is shown in the Box UI to users uploading files. This defaults to title of the file request that was copied to create this file request.

description string? - The optional description of this file request. This is shown in the Box UI to users uploading files. This defaults to description of the file request that was copied to create this file request.

status string? - The status of the file request. This defaults to active. When the status is set to inactive, the file request will no longer accept new submissions, and any visitor to the file request URL will receive a HTTP 404 status code. This defaults to status of file request that was copied to create this file request.

is_email_required boolean? - Whether a file request submitter is required to provide their email address. When this setting is set to true, the Box UI will show an email field on the file request form. This defaults to setting of file request that was copied to create this file request.

is_description_required boolean? - Whether a file request submitter is required to provide a description of the files they are submitting. When this setting is set to true, the Box UI will show a description field on the file request form. This defaults to setting of file request that was copied to create this file request.

expires_at string? - The date after which a file request will no longer accept new submissions. After this date, the status will automatically be set to inactive.

folder FolderMini? - A mini representation of a file version, used when nested under another resource.

url string? - The generated URL for this file request. This URL can be shared with users to let them upload files to the associated folder.

etag string? - The HTTP etag of this file. This can be used in combination with the If-Match header when updating a file request. By providing that header, a change will only be performed on the file request if the etag on the file request still matches the etag provided in the If-Match header.

created_by UserMini? - A mini representation of a user, as can be returned when nested within other resources.

created_at string? - The date and time when the file request was created.

updated_by UserMini? - A mini representation of a user, as can be returned when nested within other resources.

updated_at string? - The date and time when the file request was last updated.

box: FileRequestCopyRequest

The request body to copy a file request.

Fields

Fields Included from *FileRequestUpdateRequest

title string
description string
status string
is_email_required boolean
is_description_required boolean
expires_at string
anydata...

folder FilerequestcopyrequestFolder? - The folder to associate the new file request to.

box: FilerequestcopyrequestFolder

The folder to associate the new file request to.

Fields

'type string? - folder

id string - The ID of the folder to associate the new file request to.

box: FileRequestUpdateRequest

The request body to update a file request.

Fields

title string? - An optional new title for the file request. This can be used to change the title of the file request. This will default to the value on the existing file request.

description string? - An optional new description for the file request. This can be used to change the description of the file request. This will default to the value on the existing file request.

status string? - An optional new status of the file request. When the status is set to inactive, the file request will no longer accept new submissions, and any visitor to the file request URL will receive a HTTP 404 status code. This will default to the value on the existing file request.

is_email_required boolean? - Whether a file request submitter is required to provide their email address. When this setting is set to true, the Box UI will show an email field on the file request form. This will default to the value on the existing file request.

is_description_required boolean? - Whether a file request submitter is required to provide a description of the files they are submitting. When this setting is set to true, the Box UI will show a description field on the file request form. This will default to the value on the existing file request.

expires_at string? - The date after which a file request will no longer accept new submissions. After this date, the status will automatically be set to inactive. This will default to the value on the existing file request.

box: Files

A list of files

Fields

total_count int? - The number of files.

entries File[]? - A list of files

box: FilescontentAttributes

The additional attributes of the file being uploaded. Mainly the name and the parent folder. These attributes are part of the multi part request body and are in JSON format. The attributes part of the body must come before the file part. Requests that do not follow this format when uploading the file will receive a HTTP 400 error with a metadata_after_file_contents error code.

Fields

name string - The name of the file

parent FilescontentAttributesParent - The parent folder to upload the file to

content_created_at string? - Defines the time the file was originally created at. If not set, the upload time will be used.

content_modified_at string? - Defines the time the file was last modified at. If not set, the upload time will be used.

box: FilescontentAttributesParent

The parent folder to upload the file to

Fields

id string - The id of the parent folder. Use 0 for the user's root folder.

box: FilesContentBody

Fields

attributes FilescontentAttributes - The additional attributes of the file being uploaded. Mainly the name and the parent folder. These attributes are part of the multi part request body and are in JSON format. <Message warning> The attributes part of the body must come before the file part. Requests that do not follow this format when uploading the file will receive a HTTP 400 error with a metadata_after_file_contents error code. </Message>

file string - The content of the file to upload to Box. <Message warning> The attributes part of the body must come before the file part. Requests that do not follow this format when uploading the file will receive a HTTP 400 error with a metadata_after_file_contents error code. </Message>

box: FileScope

A relation between a file and the scopes for which the file can be accessed

Fields

scope string? - The file scopes for the file access

'object FileMini? - A mini representation of a file, used when nested under another resource.

box: FilesFileIdaddSharedLinkBody

Fields

shared_link FilesfileIdaddSharedLinkSharedLink? - The settings for the shared link to create on the file. Use an empty object ({}) to use the default settings for shared links.

box: FilesfileIdaddSharedLinkSharedLink

The settings for the shared link to create on the file. Use an empty object ({}) to use the default settings for shared links.

Fields

access string? - The level of access for the shared link. This can be restricted to anyone with the link (open), only people within the company (company) and only those who have been invited to the file (collaborators). If not set, this field defaults to the access level specified by the enterprise admin. To create a shared link with this default setting pass the shared_link object with no access field, for example { "shared_link": {} }. The company access level is only available to paid accounts.

password string? - The password required to access the shared link. Set the password to null to remove it. A password can only be set when access is set to open.

vanity_name string? - Defines a custom vanity name to use in the shared link URL, for example https://app.box.com/v/my-shared-link. Custom URLs should not be used when sharing sensitive content as vanity URLs are a lot easier to guess than regular shared links.

unshared_at string? - The timestamp at which this shared link will expire. This field can only be set by users with paid accounts. The value must be greater than the current date and time.

permissions FilesfileIdaddSharedLinkSharedLinkPermissions? - The permissions on shared link.

box: FilesfileIdaddSharedLinkSharedLinkPermissions

The permissions on shared link.

Fields

can_download boolean? - If the shared link allows for downloading of files. This can only be set when access is set to open or company.

box: FilesFileIdBody

Fields

name string? - An optional different name for the file. This can be used to rename the file.

description string? - The description for a file. This can be seen in the right-hand sidebar panel when viewing a file in the Box web app. Additionally, this index is used in the search index of the file, allowing users to find the file by the content in the description.

parent FilesfileIdParent? - The parent for this item

shared_link FilesfileIdSharedLink? - Defines a shared link for an item. Set this to null to remove the shared link.

'lock FilesfileIdLock? - Defines a lock on an item. This prevents the item from being moved, renamed, or otherwise changed by anyone other than the user who created the lock. Set this to null to remove the lock.

permissions FilesfileIdPermissions? - Defines who can download a file.

tags string[]? - The tags for this item. These tags are shown in the Box web app and mobile apps next to an item. To add or remove a tag, retrieve the item's current tags, modify them, and then update this field. There is a limit of 100 tags per item, and 10,000 unique tags per enterprise.

box: FilesFileIdBody1

Fields

name string? - An optional new name for the file.

parent FilesfileIdParent? - The parent for this item

box: FilesfileIdcontentAttributes

Fields

name string - An optional new name for the file. If specified, the file will be renamed when the new version is uploaded.

content_modified_at string? - Defines the time the file was last modified at. If not set, the upload time will be used.

box: FilesfileIdcopyParent

The destination folder to copy the file to.

Fields

id string - The ID of folder to copy the file to.

box: FilesfileIdLock

Defines a lock on an item. This prevents the item from being moved, renamed, or otherwise changed by anyone other than the user who created the lock. Set this to null to remove the lock.

Fields

access string? - The type of this object.

expires_at string? - Defines the time at which the lock expires.

is_download_prevented boolean? - Defines if the file can be downloaded while it is locked.

box: FilesfileIdParent

The parent for this item

Fields

id string? - The ID of parent item

box: FilesfileIdPermissions

Defines who can download a file.

Fields

can_download string? - Defines who is allowed to download this file. The possible values are either open for everyone or company for the other members of the user's enterprise. This setting overrides the download permissions that are normally part of the role of a collaboration. When set to company, this essentially removes the download option for external users with viewer or editor a roles.

box: FilesFileIdremoveSharedLinkBody

Fields

shared_link record {}? - By setting this value to null, the shared link is removed from the file.

box: FilesfileIdSharedLink

Defines a shared link for an item. Set this to null to remove the shared link.

Fields

access string? - The level of access for the shared link. This can be restricted to anyone with the link (open), only people within the company (company) and only those who have been invited to the folder (collaborators). If not set, this field defaults to the access level specified by the enterprise admin. To create a shared link with this default setting pass the shared_link object with no access field, for example { "shared_link": {} }. The company access level is only available to paid accounts.

password string? - The password required to access the shared link. Set the password to null to remove it. A password can only be set when access is set to open.

vanity_name string? - Defines a custom vanity name to use in the shared link URL, for example https://app.box.com/v/my-shared-link. Custom URLs should not be used when sharing sensitive content as vanity URLs are a lot easier to guess than regular shared links.

unshared_at string? - The timestamp at which this shared link will expire. This field can only be set by users with paid accounts.

permissions FilesfileIdSharedLinkPermissions? - The permissions for the shared link.

box: FilesfileIdSharedLinkPermissions

The permissions for the shared link.

Fields

can_download boolean? - If the shared link allows for downloading of files. This can only be set when access is set to open or company.

box: FilesFileIdupdateSharedLinkBody

Fields

shared_link FilesfileIdupdateSharedLinkSharedLink? - The settings for the shared link to update.

box: FilesfileIdupdateSharedLinkSharedLink

The settings for the shared link to update.

Fields

access string? - The level of access for the shared link. This can be restricted to anyone with the link (open), only people within the company (company) and only those who have been invited to the folder (collaborators). If not set, this field defaults to the access level specified by the enterprise admin. To create a shared link with this default setting pass the shared_link object with no access field, for example { "shared_link": {} }. The company access level is only available to paid accounts.

password string? - The password required to access the shared link. Set the password to null to remove it. A password can only be set when access is set to open.

vanity_name string? - Defines a custom vanity name to use in the shared link URL, for example https://app.box.com/v/my-shared-link. Custom URLs should not be used when sharing sensitive content as vanity URLs are a lot easier to guess than regular shared links.

unshared_at string? - The timestamp at which this shared link will expire. This field can only be set by users with paid accounts. The value must be greater than the current date and time.

permissions FilesfileIdaddSharedLinkSharedLinkPermissions? - The permissions on shared link.

box: FilesfileIdwatermarkWatermark

The watermark to imprint on the file

Fields

imprint string - The type of watermark to apply. Currently only supports one option.

box: FilesUploadSessionsBody

Fields

folder_id string - The ID of the folder to upload the new file to.

file_size int - The total number of bytes of the file to be uploaded

file_name string - The name of new file

box: FileVersion

A standard representation of a file version

Fields

Fields Included from *FileversionMini

sha1 string
id string
type string
anydata...

name string? - The name of the file version

size int? - Size of the file version in bytes

created_at string? - When the file version object was created

modified_at string? - When the file version object was last updated

modified_by record {}? -

trashed_at string? - When the file version object was trashed.

trashed_by record {}? -

restored_at string? - When the file version was restored from the trash.

restored_by record {}? -

purged_at string? - When the file version object will be permanently deleted.

uploader_display_name record {}? -

box: FileversionBase

The bare basic representation of a file version, the minimal amount of fields returned when using the fields query parameter.

Fields

id string? - The unique identifier that represent a file version.

'type string? - file_version

box: FileVersionLegalHold

File-Version-Legal-Hold is an entity representing all holds on a File Version.

Fields

id string? - The unique identifier for this file version legal hold

'type string? - file_version_legal_hold

file_version FileversionMini? - A mini representation of a file version, used when nested within another resource.

file FileMini? - A mini representation of a file, used when nested under another resource.

legal_hold_policy_assignments LegalHoldPolicyAssignment[]? - List of assignments contributing to this Hold.

deleted_at string? - Time that this File-Version-Legal-Hold was deleted.

box: FileVersionLegalHolds

A list of file version legal holds.

Fields

'limit int? - The limit that was used for these entries. This will be the same as the limit query parameter unless that value exceeded the maximum value allowed. The maximum value varies by API.

next_marker int? - The marker for the start of the next page of results.

prev_marker int? - The marker for the start of the previous page of results.

entries FileVersionLegalHold[]? -

box: FileversionMini

A mini representation of a file version, used when nested within another resource.

Fields

Fields Included from *FileversionBase

id string
type string
anydata...

sha1 string? - The SHA1 hash of this version of the file.

box: FileVersionRetention

A retention policy blocks permanent deletion of content for a specified amount of time. Admins can apply policies to specified folders, or an entire enterprise. A file version retention is a record for a retained file version. To use this feature, you must have the manage retention policies scope enabled for your API key via your application management console. For more information about retention policies, please visit our help documentation

Fields

id string? - The unique identifier for this file version retention.

'type string? - file_version_retention

file_version FileversionMini? - A mini representation of a file version, used when nested within another resource.

file FileMini? - A mini representation of a file, used when nested under another resource.

applied_at string? - When this file version retention object was created

disposition_at string? - When the retention expires on this file version retention

winning_retention_policy RetentionpolicyMini? - A mini representation of a retention policy, used when nested within another resource.

box: FileVersionRetentions

A list of file version retentions.

Fields

'limit int? - The limit that was used for these entries. This will be the same as the limit query parameter unless that value exceeded the maximum value allowed. The maximum value varies by API.

next_marker int? - The marker for the start of the next page of results.

prev_marker int? - The marker for the start of the previous page of results.

entries FileVersionRetention[]? -

box: FileVersions

A list of file versions

Fields

total_count int? - One greater than the offset of the last entry in the entire collection. The total number of entries in the collection may be less than total_count. This field is only returned for calls that use offset-based pagination. For marker-based paginated APIs, this field will be omitted.

'limit int? - The limit that was used for these entries. This will be the same as the limit query parameter unless that value exceeded the maximum value allowed. The maximum value varies by API.

offset int? - The 0-based offset of the first entry in this set. This will be the same as the offset query parameter. This field is only returned for calls that use offset-based pagination. For marker-based paginated APIs, this field will be omitted.

'order CollaborationsOrder[]? - The order by which items are returned. This field is only returned for calls that use offset-based pagination. For marker-based paginated APIs, this field will be omitted.

entries FileVersion[]? -

box: Folder

A standard representation of a folder, as returned from any folder API endpoints by default

Fields

Fields Included from *FolderMini

sequence_id record { anydata... }
name string
id string
etag string|()
type string
anydata...

created_at string? - The date and time when the folder was created. This value may be null for some folders such as the root folder or the trash folder.

modified_at string? - The date and time when the folder was last updated. This value may be null for some folders such as the root folder or the trash folder.

description record {}? -

size int? - The folder size in bytes. Be careful parsing this integer as its value can get very large.

path_collection record { total_count int, entries FolderMini[] }? -

created_by record {}? -

modified_by record {}? -

trashed_at string? - The time at which this folder was put in the trash.

purged_at string? - The time at which this folder is expected to be purged from the trash.

content_created_at string? - The date and time at which this folder was originally created.

content_modified_at string? - The date and time at which this folder was last updated.

expires_at string? - The time and which the folder will be automatically be deleted.

owned_by record {}? -

shared_link record { url string, download_url string?, vanity_url string?, vanity_name string?, access string, effective_access string, effective_permission string, unshared_at string?, is_password_enabled boolean, permissions record { can_download boolean, can_preview boolean }, download_count int, preview_count int }? -

folder_upload_email FolderFolderUploadEmail? -

parent record {}? -

item_status string? - Defines if this item has been deleted or not. * active when the item has is not in the trash * trashed when the item has been moved to the trash but not deleted * deleted when the item has been permanently deleted.

item_collection record {}? -

box: FolderBase

The bare basic representation of a folder, the minimal amount of fields returned when using the fields query parameter.

Fields

id string? - The unique identifier that represent a folder. The ID for any folder can be determined by visiting a folder in the web application and copying the ID from the URL. For example, for the URL https://*.app.box.com/folders/123 the folder_id is 123.

etag string? - The HTTP etag of this folder. This can be used within some API endpoints in the If-Match and If-None-Match headers to only perform changes on the folder if (no) changes have happened.

'type string? - folder

box: FolderFolderUploadEmail

Fields

access string? - When this parameter has been set, users can email files to the email address that has been automatically created for this folder. To create an email address, set this property either when creating or updating the folder. When set to collaborators, only emails from registered email addresses for collaborators will be accepted. This includes any email aliases a user might have registered. When set to open it will accept emails from any email address.

email string? - The optional upload email address for this folder.

box: FolderFull

A full representation of a folder, as can be returned from any folder API endpoints by default

Fields

Fields Included from *Folder

created_at string|()
modified_at string|()
description record { anydata... }
size int
path_collection record { total_count int, entries FolderMini[], anydata... }
created_by record { name string, login string, id string, type string, anydata... }
modified_by record { name string, login string, id string, type string, anydata... }
trashed_at string|()
purged_at string|()
content_created_at string|()
content_modified_at string|()
expires_at string|()
owned_by record { name string, login string, id string, type string, anydata... }
shared_link record { url string, download_url string|(), vanity_url string|(), vanity_name string|(), access string, effective_access string, effective_permission string, unshared_at string|(), is_password_enabled boolean, permissions record { can_download boolean, can_preview boolean, anydata... }, download_count int, preview_count int, anydata... }
folder_upload_email FolderFolderUploadEmail|()
parent record { sequence_id record { anydata... }, name string, id string, etag string|(), type string, anydata... }
item_status string
item_collection record { total_count int, limit int, offset int, order CollaborationsOrder[], entries FileMini|FolderMini|WeblinkMini[], anydata... }
sequence_id record { anydata... }
name string
id string
etag string|()
type string
anydata...

sync_state record {}? -

has_collaborations boolean? - Specifies if this folder has any other collaborators.

permissions record { can_delete boolean, can_download boolean, can_invite_collaborator boolean, can_rename boolean, can_set_share_access boolean, can_share boolean, can_upload boolean }? -

tags record {}? -

can_non_owners_invite record {}? -

is_externally_owned boolean? - Specifies if this folder is owned by a user outside of the authenticated enterprise.

metadata record {}? -

is_collaboration_restricted_to_enterprise record {}? -

allowed_shared_link_access_levels string[]? - A list of access levels that are available for this folder. For some folders, like the root folder, this will always be an empty list as sharing is not allowed at that level.

allowed_invitee_roles string[]? - A list of the types of roles that user can be invited at when sharing this folder.

watermark_info record { is_watermarked boolean }? -

can_non_owners_view_collaborators boolean? - Specifies if collaborators who are not owners of this folder are restricted from viewing other collaborations on this folder. It also restricts non-owners from inviting new collaborators.

classification record { name string, definition string, color string }? -

box: FolderIdCopyBody

Fields

name string? - An optional new name for the copied folder. There are some restrictions to the file name. Names containing non-printable ASCII characters, forward and backward slashes (/, \), as well as names with trailing spaces are prohibited. Additionally, the names . and .. are not allowed either. MISSING[`]

parent FoldersfolderIdcopyParent - The destination folder to copy the folder to.

box: FolderIdWatermarkBody

Fields

watermark FoldersfolderIdwatermarkWatermark - The watermark to imprint on the folder

box: FolderLock

Folder locks define access restrictions placed by folder owners to prevent specific folders from being moved or deleted.

Fields

folder FolderMini? - A mini representation of a file version, used when nested under another resource.

id string? - The unique identifier for this folder lock.

'type string? - The object type, always folder_lock.

created_by UserBase? - A mini representation of a user, used when nested within another resource.

created_at string? - When the folder lock object was created.

locked_operations FolderlockLockedOperations? - The operations that have been locked. Currently the move and delete operations cannot be locked separately, and both need to be set to true.

lock_type string? - The lock type, always freeze.

box: FolderlockLockedOperations

The operations that have been locked. Currently the move and delete operations cannot be locked separately, and both need to be set to true.

Fields

move boolean? - Whether moving the folder is restricted.

delete boolean? - Whether deleting the folder is restricted.

box: FolderLocks

A list of folder locks

Fields

'limit int? - The limit that was used for these entries. This will be the same as the limit query parameter unless that value exceeded the maximum value allowed. The maximum value varies by API.

next_marker int? - The marker for the start of the next page of results.

prev_marker int? - The marker for the start of the previous page of results.

entries FolderLock[]? -

box: FolderLocksBody

Fields

locked_operations FolderLocksLockedOperations? - The operations to lock for the folder. If locked_operations is included in the request, both move and delete must also be included and both set to true.

folder FolderLocksFolder - The folder to apply the lock to.

box: FolderLocksFolder

The folder to apply the lock to.

Fields

'type string - The content type the lock is being applied to. Only folder is supported.

id string - The ID of the folder.

box: FolderLocksLockedOperations

The operations to lock for the folder. If locked_operations is included in the request, both move and delete must also be included and both set to true.

Fields

move boolean - Whether moving the folder should be locked.

delete boolean - Whether deleting the folder should be locked.

box: FolderMini

A mini representation of a file version, used when nested under another resource.

Fields

Fields Included from *FolderBase

id string
etag string|()
type string
anydata...

sequence_id record {}? -

name string? - The name of the folder.

box: Folders0Body

Fields

owned_by UsersuserIdfolders0OwnedBy - The user who the folder will be transferred to

box: FoldersBody

Fields

name string - The name for the new folder. There are some restrictions to the file name. Names containing non-printable ASCII characters, forward and backward slashes (/, \), as well as names with trailing spaces are prohibited. Additionally, the names . and .. are not allowed either. MISSING[`]

parent FoldersParent - The parent folder to create the new folder within.

folder_upload_email record { access string }? -

sync_state string? - Specifies whether a folder should be synced to a user's device or not. This is used by Box Sync (discontinued) and is not used by Box Drive.

box: FoldersFolderIdaddSharedLinkBody

Fields

shared_link FoldersfolderIdaddSharedLinkSharedLink? - The settings for the shared link to create on the folder. Use an empty object ({}) to use the default settings for shared links.

box: FoldersfolderIdaddSharedLinkSharedLink

The settings for the shared link to create on the folder. Use an empty object ({}) to use the default settings for shared links.

Fields

access string? - The level of access for the shared link. This can be restricted to anyone with the link (open), only people within the company (company) and only those who have been invited to the folder (collaborators). If not set, this field defaults to the access level specified by the enterprise admin. To create a shared link with this default setting pass the shared_link object with no access field, for example { "shared_link": {} }. The company access level is only available to paid accounts.

password string? - The password required to access the shared link. Set the password to null to remove it. A password can only be set when access is set to open.

unshared_at string? - The timestamp at which this shared link will expire. This field can only be set by users with paid accounts. The value must be greater than the current date and time.

permissions FoldersfolderIdaddSharedLinkSharedLinkPermissions? - The permissions on shared link.

box: FoldersfolderIdaddSharedLinkSharedLinkPermissions

The permissions on shared link.

Fields

can_download boolean? - If the shared link allows for downloading of folders. This can only be set when access is set to open or company.

box: FoldersFolderIdBody

Fields

name string? - The optional new name for this folder.

description string? - The optional description of this folder

sync_state string? - Specifies whether a folder should be synced to a user's device or not. This is used by Box Sync (discontinued) and is not used by Box Drive.

can_non_owners_invite boolean? - Specifies if users who are not the owner of the folder can invite new collaborators to the folder.

parent FoldersfolderIdParent? - The parent folder for this folder. Use this to move the folder or to restore it out of the trash.

shared_link record { access string, password string, vanity_name string, unshared_at string, permissions record { can_download boolean } }? -

folder_upload_email record { access string }? -

tags string[]? - The tags for this item. These tags are shown in the Box web app and mobile apps next to an item. To add or remove a tag, retrieve the item's current tags, modify them, and then update this field. There is a limit of 100 tags per item, and 10,000 unique tags per enterprise.

is_collaboration_restricted_to_enterprise boolean? - Specifies if new invites to this folder are restricted to users within the enterprise. This does not affect existing collaborations.

collections Reference[]? - An array of collections to make this folder a member of. Currently we only support the favorites collection. To get the ID for a collection, use the [List all collections][1] endpoint. Passing an empty array [] or null will remove the folder from all collections. [1]: ../advanced-files-and-folders/#get-collections

can_non_owners_view_collaborators boolean? - Restricts collaborators who are not the owner of this folder from viewing other collaborations on this folder. It also restricts non-owners from inviting new collaborators. When setting this field to false, it is required to also set can_non_owners_invite_collaborators to false if it has not already been set.

box: FoldersFolderIdBody1

Fields

name string? - An optional new name for the folder.

parent record { id string }? -

box: FoldersfolderIdcopyParent

The destination folder to copy the folder to.

Fields

id string - The ID of parent folder

box: FoldersfolderIdParent

The parent folder for this folder. Use this to move the folder or to restore it out of the trash.

Fields

id string? - The ID of the new parent folder

box: FoldersFolderIdremoveSharedLinkBody

Fields

shared_link record {}? - By setting this value to null, the shared link is removed from the folder.

box: FoldersFolderIdupdateSharedLinkBody

Fields

shared_link FoldersfolderIdupdateSharedLinkSharedLink? - The settings for the shared link to update.

box: FoldersfolderIdupdateSharedLinkSharedLink

The settings for the shared link to update.

Fields

access string? - The level of access for the shared link. This can be restricted to anyone with the link (open), only people within the company (company) and only those who have been invited to the folder (collaborators). If not set, this field defaults to the access level specified by the enterprise admin. To create a shared link with this default setting pass the shared_link object with no access field, for example { "shared_link": {} }. The company access level is only available to paid accounts.

password string? - The password required to access the shared link. Set the password to null to remove it. A password can only be set when access is set to open.

unshared_at string? - The timestamp at which this shared link will expire. This field can only be set by users with paid accounts. The value must be greater than the current date and time.

permissions FoldersfolderIdaddSharedLinkSharedLinkPermissions? - The permissions on shared link.

box: FoldersfolderIdwatermarkWatermark

The watermark to imprint on the folder

Fields

imprint string - The type of watermark to apply. Currently only supports one option.

box: FoldersParent

The parent folder to create the new folder within.

Fields

id string - The ID of parent folder

box: Group

A standard representation of a group, as returned from any group API endpoints by default

Fields

Fields Included from *GroupMini

name string
group_type string
id string
type string
anydata...

created_at string? - When the group object was created

modified_at string? - When the group object was last modified

box: GroupBase

A base representation of a group.

Fields

id string? - The unique identifier for this object

'type string? - group

box: GroupFull

Groups contain a set of users, and can be used in place of users in some operations, such as collaborations.

Fields

Fields Included from *Group

created_at string
modified_at string
name string
group_type string
id string
type string
anydata...

provenance string? - Keeps track of which external source this group is coming from (e.g. "Active Directory", "Google Groups", "Facebook Groups"). Setting this will also prevent Box users from editing the group name and its members directly via the Box web application. This is desirable for one-way syncing of groups.

external_sync_identifier string? - An arbitrary identifier that can be used by external group sync tools to link this Box Group to an external group. Example values of this field could be an Active Directory Object ID or a Google Group ID. We recommend you use of this field in order to avoid issues when group names are updated in either Box or external systems.

description string? - Human readable description of the group.

invitability_level string? - Specifies who can invite the group to collaborate on items. When set to admins_only the enterprise admin, co-admins, and the group's admin can invite the group. When set to admins_and_members all the admins listed above and group members can invite the group. When set to all_managed_users all managed users in the enterprise can invite the group.

member_viewability_level string? - Specifies who can view the members of the group (Get Memberships for Group). * admins_only - the enterprise admin, co-admins, group's group admin * admins_and_members - all admins and group members * all_managed_users - all managed users in the enterprise

permissions record { can_invite_as_collaborator boolean }? -

box: GroupMembership

Membership is used to signify that a user is part of a group.

Fields

id string? - The unique identifier for this group membership

'type string? - group_membership

user UserMini? - A mini representation of a user, as can be returned when nested within other resources.

group GroupMini? - Mini representation of a group, including id and name of group.

role string? - The role of the user in the group.

created_at string? - The time this membership was created.

modified_at string? - The time this membership was last modified.

box: GroupMemberships

A list of group memberships.

Fields

total_count int? - One greater than the offset of the last entry in the entire collection. The total number of entries in the collection may be less than total_count. This field is only returned for calls that use offset-based pagination. For marker-based paginated APIs, this field will be omitted.

'limit int? - The limit that was used for these entries. This will be the same as the limit query parameter unless that value exceeded the maximum value allowed. The maximum value varies by API.

offset int? - The 0-based offset of the first entry in this set. This will be the same as the offset query parameter. This field is only returned for calls that use offset-based pagination. For marker-based paginated APIs, this field will be omitted.

'order CollaborationsOrder[]? - The order by which items are returned. This field is only returned for calls that use offset-based pagination. For marker-based paginated APIs, this field will be omitted.

entries GroupMembership[]? -

box: GroupMembershipsBody

Fields

user GroupMembershipsUser - The user to add to the group.

group GroupMembershipsGroup - The group to add the user to.

role string? - The role of the user in the group.

configurable_permissions record {}? - Custom configuration for the permissions an admin if a group will receive. This option has no effect on members with a role of member. Setting these permissions overwrites the default access levels of an admin. Specifying a value of "null" for this object will disable all configurable permissions. Specifying permissions will set them accordingly, omitted permissions will be enabled by default.

box: GroupMembershipsGroup

The group to add the user to.

Fields

id string - The ID of the group to add the user to

box: GroupMembershipsGroupMembershipIdBody

Fields

role string? - The role of the user in the group.

configurable_permissions record {}? - Custom configuration for the permissions an admin if a group will receive. This option has no effect on members with a role of member. Setting these permissions overwrites the default access levels of an admin. Specifying a value of "null" for this object will disable all configurable permissions. Specifying permissions will set them accordingly, omitted permissions will be enabled by default.

box: GroupMembershipsUser

The user to add to the group.

Fields

id string - The ID of the user to add to the group

box: GroupMini

Mini representation of a group, including id and name of group.

Fields

Fields Included from *GroupBase

id string
type string
anydata...

name string? - The name of the group

group_type string? - The type of the group.

box: Groups

A list of groups.

Fields

total_count int? - One greater than the offset of the last entry in the entire collection. The total number of entries in the collection may be less than total_count. This field is only returned for calls that use offset-based pagination. For marker-based paginated APIs, this field will be omitted.

'limit int? - The limit that was used for these entries. This will be the same as the limit query parameter unless that value exceeded the maximum value allowed. The maximum value varies by API.

offset int? - The 0-based offset of the first entry in this set. This will be the same as the offset query parameter. This field is only returned for calls that use offset-based pagination. For marker-based paginated APIs, this field will be omitted.

'order CollaborationsOrder[]? - The order by which items are returned. This field is only returned for calls that use offset-based pagination. For marker-based paginated APIs, this field will be omitted.

entries GroupMini[]? -

box: GroupsBody

Fields

name string - The name of the new group to be created. This name must be unique within the enterprise.

provenance string? - Keeps track of which external source this group is coming, for example Active Directory, or Okta. Setting this will also prevent Box admins from editing the group name and its members directly via the Box web application. This is desirable for one-way syncing of groups.

external_sync_identifier string? - An arbitrary identifier that can be used by external group sync tools to link this Box Group to an external group. Example values of this field could be an Active Directory Object ID or a Google Group ID. We recommend you use of this field in order to avoid issues when group names are updated in either Box or external systems.

description string? - A human readable description of the group.

invitability_level string? - Specifies who can invite the group to collaborate on folders. When set to admins_only the enterprise admin, co-admins, and the group's admin can invite the group. When set to admins_and_members all the admins listed above and group members can invite the group. When set to all_managed_users all managed users in the enterprise can invite the group.

member_viewability_level string? - Specifies who can see the members of the group. * admins_only - the enterprise admin, co-admins, group's group admin * admins_and_members - all admins and group members * all_managed_users - all managed users in the enterprise

box: GroupsGroupIdBody

Fields

name string? - The name of the new group to be created. Must be unique within the enterprise.

provenance string? - Keeps track of which external source this group is coming, for example Active Directory, or Okta. Setting this will also prevent Box admins from editing the group name and its members directly via the Box web application. This is desirable for one-way syncing of groups.

external_sync_identifier string? - An arbitrary identifier that can be used by external group sync tools to link this Box Group to an external group. Example values of this field could be an Active Directory Object ID or a Google Group ID. We recommend you use of this field in order to avoid issues when group names are updated in either Box or external systems.

description string? - A human readable description of the group.

invitability_level string? - Specifies who can invite the group to collaborate on folders. When set to admins_only the enterprise admin, co-admins, and the group's admin can invite the group. When set to admins_and_members all the admins listed above and group members can invite the group. When set to all_managed_users all managed users in the enterprise can invite the group.

member_viewability_level string? - Specifies who can see the members of the group. * admins_only - the enterprise admin, co-admins, group's group admin * admins_and_members - all admins and group members * all_managed_users - all managed users in the enterprise

box: Invite

An invite for a user to an enterprise.

Fields

id string? - The unique identifier for this invite

'type string? - invite

invited_to Enterprise? - A representation of a Box enterprise

actionable_by UserMini? - A mini representation of a user, as can be returned when nested within other resources.

invited_by UserMini? - A mini representation of a user, as can be returned when nested within other resources.

status string? - The status of the invite

created_at string? - When the invite was created

modified_at string? - When the invite was modified.

box: InvitesActionableBy

The user to invite

Fields

box: InvitesBody

Fields

enterprise InvitesEnterprise - The enterprise to invite the user to

actionable_by InvitesActionableBy - The user to invite

box: InvitesEnterprise

The enterprise to invite the user to

Fields

id string - The ID of the enterprise

box: Items

A list of files, folders, and web links in their mini representation.

Fields

total_count int? - One greater than the offset of the last entry in the entire collection. The total number of entries in the collection may be less than total_count. This field is only returned for calls that use offset-based pagination. For marker-based paginated APIs, this field will be omitted.

'limit int? - The limit that was used for these entries. This will be the same as the limit query parameter unless that value exceeded the maximum value allowed. The maximum value varies by API.

offset int? - The 0-based offset of the first entry in this set. This will be the same as the offset query parameter. This field is only returned for calls that use offset-based pagination. For marker-based paginated APIs, this field will be omitted.

'order CollaborationsOrder[]? - The order by which items are returned. This field is only returned for calls that use offset-based pagination. For marker-based paginated APIs, this field will be omitted.

entries (FileMini|FolderMini|WeblinkMini)[]? - The items in this collection.

box: KeywordSkillCard

A skill card that contains a set of keywords

Fields

created_at string? - The optional date and time this card was created at.

'type string - skill_card

skill_card_type string - keyword

skill_card_title KeywordskillcardSkillCardTitle? - The title of the card.

skill SkillcardSkill - The service that applied this metadata.

invocation SkillcardInvocation - The invocation of this service, used to track which instance of a service applied the metadata.

entries KeywordskillcardEntries[] - An list of entries in the metadata card.

box: KeywordskillcardEntries

An entry in the entries attribute of a metadata card

Fields

text string? - The text of the keyword.

box: KeywordskillcardSkillCardTitle

The title of the card.

Fields

code string? - An optional identifier for the title.

message string - The actual title to show in the UI.

box: LegalHoldPolicies

A list of legal hold policies.

Fields

'limit int? - The limit that was used for these entries. This will be the same as the limit query parameter unless that value exceeded the maximum value allowed. The maximum value varies by API.

next_marker int? - The marker for the start of the next page of results.

prev_marker int? - The marker for the start of the previous page of results.

entries LegalHoldPolicy[]? -

box: LegalHoldPoliciesBody

Fields

policy_name string - The name of the policy.

description string? - A description for the policy.

filter_started_at string? - The filter start date. When this policy is applied using a custodian legal hold assignments, it will only apply to file versions created or uploaded inside of the date range. Other assignment types, such as folders and files, will ignore the date filter. Required if is_ongoing is set to false.

filter_ended_at string? - The filter end date. When this policy is applied using a custodian legal hold assignments, it will only apply to file versions created or uploaded inside of the date range. Other assignment types, such as folders and files, will ignore the date filter. Required if is_ongoing is set to false.

is_ongoing boolean? - Whether new assignments under this policy should continue applying to files even after initialization. When this policy is applied using a legal hold assignment, it will continue applying the policy to any new file versions even after it has been applied. For example, if a legal hold assignment is placed on a user today, and that user uploads a file tomorrow, that file will get held. This will continue until the policy is retired. Required if no filter dates are set.

box: LegalHoldPoliciesLegalHoldPolicyIdBody

Fields

policy_name string? - The name of the policy.

description string? - A description for the policy.

release_notes string? - Notes around why the policy was released.

box: LegalHoldPolicy

Legal Hold Policy information describes the basic characteristics of the Policy, such as name, description, and filter dates.

Fields

Fields Included from *LegalholdpolicyMini

id string
type string
anydata...

policy_name string? - Name of the legal hold policy.

description string? - Description of the legal hold policy. Optional property with a 500 character limit.

status string? -
- 'active' - the policy is not in a transition state * 'applying' - that the policy is in the process of being applied * 'releasing' - that the process is in the process of being released * 'released' - the policy is no longer active

assignment_counts LegalholdpolicyAssignmentCounts? - Counts of assignments within this a legal hold policy by item type

created_by record {}? -

created_at string? - When the legal hold policy object was created

modified_at string? - When the legal hold policy object was modified. Does not update when assignments are added or removed.

deleted_at string? - When the policy release request was sent. (Because it can take time for a policy to fully delete, this isn't quite the same time that the policy is fully deleted). If null, the policy was not deleted.

filter_started_at string? - User-specified, optional date filter applies to Custodian assignments only

filter_ended_at string? - User-specified, optional date filter applies to Custodian assignments only

release_notes string? - Optional notes about why the policy was created.

box: LegalHoldPolicyAssignment

Legal Hold Assignments are used to assign Legal Hold Policies to Users, Folders, Files, or File Versions. Creating a Legal Hold Assignment puts a hold on the File-Versions that belong to the Assignment's 'apply-to' entity.

Fields

Fields Included from *LegalholdpolicyassignmentBase

id string
type string
anydata...

legal_hold_policy record {}? -

assigned_to File|Folder|WebLink? - The item that the the legal hold policy is assigned to. Includes type and ID.

assigned_by record {}? -

assigned_at string? - When the legal hold policy assignment object was created

deleted_at string? - When the assignment release request was sent. (Because it can take time for an assignment to fully delete, this isn't quite the same time that the assignment is fully deleted). If null, Assignment was not deleted.

box: LegalholdpolicyassignmentBase

Fields

id string? - The unique identifier for this legal hold assignment

'type string? - legal_hold_policy_assignment

box: LegalholdpolicyAssignmentCounts

Counts of assignments within this a legal hold policy by item type

Fields

user int? - The number of users this policy is applied to

folder int? - The number of folders this policy is applied to

file int? - The number of files this policy is applied to

file_version int? - The number of file versions this policy is applied to

box: LegalHoldPolicyAssignments

A list of legal hold policies assignments.

Fields

'limit int? - The limit that was used for these entries. This will be the same as the limit query parameter unless that value exceeded the maximum value allowed. The maximum value varies by API.

next_marker int? - The marker for the start of the next page of results.

prev_marker int? - The marker for the start of the previous page of results.

entries LegalholdpolicyassignmentBase[]? -

box: LegalHoldPolicyAssignmentsAssignTo

The item to assign the policy to

Fields

'type string - The type of item to assign the policy to

id string - The ID of item to assign the policy to

box: LegalHoldPolicyAssignmentsBody

Fields

policy_id string - The ID of the policy to assign.

assign_to LegalHoldPolicyAssignmentsAssignTo - The item to assign the policy to

box: LegalholdpolicyMini

A mini legal hold policy

Fields

id string? - The unique identifier for this legal hold policy

'type string? - legal_hold_policy

box: NameconflictInner

A file or folder for which a conflict was encountered, This object provides the type and identifier of the original item, as well as a mapping between its original name and it's new name as it will appear in the archive.

Fields

id string? - The identifier of the item

'type string? - The type of this item

original_name string? - The original name of this item

download_name string? - The new name of this item as it will appear in the downloaded zip archive.

box: OAuth2Error

An OAuth 2.0 error

Fields

'error string? - The type of the error returned.

error_description string? - The type of the error returned.

box: OAuth2RefreshTokenGrantConfig

Closed record

OAuth2 Refresh Token Grant Configs

Fields

Fields Included from *OAuth2RefreshTokenGrantConfig

refreshUrl string
refreshToken string
clientId string
clientSecret string
scopes string|string[]
defaultTokenExpTime decimal
clockSkew decimal
optionalParams map<string>
credentialBearer CredentialBearer
clientConfig ClientConfiguration

refreshUrl string(default "https://api.box.com/oauth2/token") - Refresh URL

box: PostOAuth2Revoke

A request to revoke an OAuth 2.0 token

Fields

client_id string? - The Client ID of the application requesting to revoke the access token.

client_secret string? - The client secret of the application requesting to revoke an access token.

token string? - The access token to revoke.

box: PostOAuth2Token

A request for a new OAuth 2.0 token

Fields

grant_type string - The type of request being made, either using a client-side obtained authorization code, a refresh token, a JWT assertion, client credentials grant or another access token for the purpose of downscoping a token.

client_id string? - The Client ID of the application requesting an access token. Used in combination with authorization_code, client_credentials, or urn:ietf:params:oauth:grant-type:jwt-bearer as the grant_type.

client_secret string? - The client secret of the application requesting an access token. Used in combination with authorization_code, client_credentials, or urn:ietf:params:oauth:grant-type:jwt-bearer as the grant_type.

code string? - The client-side authorization code passed to your application by Box in the browser redirect after the user has successfully granted your application permission to make API calls on their behalf. Used in combination with authorization_code as the grant_type.

refresh_token string? - A refresh token used to get a new access token with. Used in combination with refresh_token as the grant_type.

assertion string? - A JWT assertion for which to request a new access token. Used in combination with urn:ietf:params:oauth:grant-type:jwt-bearer as the grant_type.

subject_token string? - The token to exchange for a downscoped token. This can be a regular access token, a JWT assertion, or an app token. Used in combination with urn:ietf:params:oauth:grant-type:token-exchange as the grant_type.

subject_token_type string? - The type of subject_token passed in. Used in combination with urn:ietf:params:oauth:grant-type:token-exchange as the grant_type.

actor_token string? - The token used to create an annotator token. This is a JWT assertion. Used in combination with urn:ietf:params:oauth:grant-type:token-exchange as the grant_type.

actor_token_type string? - The type of actor_token passed in. Used in combination with urn:ietf:params:oauth:grant-type:token-exchange as the grant_type.

scope string? - The space-delimited list of scopes that you want apply to the new access token. The subject_token will need to have all of these scopes or the call will error with 401 Unauthorized.

'resource string? - Full URL for the file that the token should be generated for.

box_subject_type string? - Used in combination with client_credentials as the grant_type.

box_subject_id string? - Used in combination with client_credentials as the grant_type. Value is determined by box_subject_type. If user use user ID and if enterprise use enterprise ID.

box_shared_link string? - Full URL of the shared link on the file or folder that the token should be generated for.

box: Postoauth2tokenRefreshaccesstoken

A request to refresh an Access Token. Use this API to refresh an expired Access Token using a valid Refresh Token.

Fields

grant_type string - The type of request being made, in this case a refresh request.

client_id string - The client ID of the application requesting to refresh the token.

client_secret string - The client secret of the application requesting to refresh the token.

refresh_token string - The refresh token to refresh.

box: ProxyConfig

Closed record

Proxy server configurations to be used with the HTTP client endpoint.

Fields

host string(default "") - Host name of the proxy server

port int(default 0) - Proxy server port

userName string(default "") - Proxy server username

password string(default "") - Proxy server password

box: RealtimeServer

A real-time server that can be used for long polling user events

Fields

'type string? - realtime_server

url string? - The URL for the server.

ttl int? - The time in minutes for which this server is available

max_retries int? - The maximum number of retries this server will allow before a new long poll should be started by getting a new list of server.

retry_timeout int? - The maximum number of seconds without a response after which you should retry the long poll connection. This helps to overcome network issues where the long poll looks to be working but no packages are coming through.

box: RealtimeServers

A list of real-time servers that can be used for long-polling.

Fields

chunk_size int? - The number of items in this response.

entries RealtimeServer[]? - The entries of realtime servers.

box: RecentItem

A recent item accessed by a user.

Fields

'type string? - recent_item

item File|Folder|WebLink? -

interaction_type string? - The most recent type of access the user performed on the item.

interacted_at string? - The time of the most recent interaction.

interaction_shared_link string? - If the item was accessed through a shared link it will appear here, otherwise this will be null.

box: RecentItems

A list of recent items.

Fields

'limit int? - The limit that was used for these entries. This will be the same as the limit query parameter unless that value exceeded the maximum value allowed. The maximum value varies by API.

next_marker int? - The marker for the start of the next page of results.

prev_marker int? - The marker for the start of the previous page of results.

entries RecentItem[]? -

box: Reference

The bare basic reference for an object

Fields

id string? - The unique identifier for this object

'type string? - The type for this object

box: RetentionPolicies

A list of retention policies

Fields

total_count int? - The number of retention policies.

entries RetentionPolicy[]? - The entries of retention policies.

box: RetentionPoliciesBody

Fields

policy_name string - The name for the retention policy

policy_type string - The type of the retention policy. A retention policy type can either be finite, where a specific amount of time to retain the content is known upfront, or indefinite, where the amount of time to retain the content is still unknown.

disposition_action string - The disposition action of the retention policy. This action can be permanently_delete, which will cause the content retained by the policy to be permanently deleted, or remove_retention, which will lift the retention policy from the content, allowing it to be deleted by users, once the retention policy has expired.

retention_length string? - The length of the retention policy. This length specifies the duration in days that the retention policy will be active for after being assigned to content. If the policy has A policy_type of indefinite, the retention_length will also be indefinite.

can_owner_extend_retention boolean? - Whether the owner of a file will be allowed to extend the retention.

are_owners_notified boolean? - Whether owner and co-owners of a file are notified when the policy nears expiration.

custom_notification_recipients RetentionPoliciesCustomNotificationRecipients[]? -

box: RetentionPoliciesCustomNotificationRecipients

A user that is notified of an event.

Fields

'type string? - The type of item to notify

id string? - The id of the user to notify

name string? - The name of the user to notify

box: RetentionPoliciesRetentionPolicyIdBody

Fields

policy_name string? - The name for the retention policy

disposition_action string? - The disposition action of the retention policy. This action can be permanently_delete, which will cause the content retained by the policy to be permanently deleted, or remove_retention, which will lift the retention policy from the content, allowing it to be deleted by users, once the retention policy has expired.

status string? - Used to retire a retention policy. If not retiring a policy, do not include this parameter or set it to null.

box: RetentionPolicy

A retention policy blocks permanent deletion of content for a specified amount of time. Admins can create retention policies and then later assign them to specific folders or their entire enterprise. To use this feature, you must have the manage retention policies scope enabled for your API key via your application management console.

Fields

Fields Included from *RetentionpolicyMini

policy_name string
retention_length string
disposition_action string
id string
type string
anydata...

policy_type string? - The type of the retention policy. A retention policy type can either be finite, where a specific amount of time to retain the content is known upfront, or indefinite, where the amount of time to retain the content is still unknown.

status string? - The status of the retention policy. The status of a policy will be active, unless explicitly retired by an administrator, in which case the status will be retired. Once a policy has been retired, it cannot become active again.

created_by record {}? -

created_at string? - When the retention policy object was created

modified_at string? - When the retention policy object was last modified

box: RetentionPolicyAssignment

The retention policy assignment endpoint provides a way for admins to apply a retention policy on a per-folder basis, or place a blanket policy over the entire enterprise.

Fields

id string? - The unique identifier for this retention policy assignment

'type string? - retention_policy_assignment

retention_policy RetentionpolicyMini? - A mini representation of a retention policy, used when nested within another resource.

assigned_to Reference? - The bare basic reference for an object

assigned_by UserMini? - A mini representation of a user, as can be returned when nested within other resources.

assigned_at string? - When the retention policy assignment object was created

box: RetentionPolicyAssignments

A list of retention policy assignments

Fields

'limit int? - The limit that was used for these entries. This will be the same as the limit query parameter unless that value exceeded the maximum value allowed. The maximum value varies by API.

next_marker int? - The marker for the start of the next page of results.

prev_marker int? - The marker for the start of the previous page of results.

entries RetentionPolicyAssignment[]? -

box: RetentionPolicyAssignmentsAssignTo

The item to assign the policy to

Fields

'type string - The type of item to assign the policy to.

id string - The ID of item to assign the policy to. Set to null or omit when type is set to enterprise.

box: RetentionPolicyAssignmentsBody

Fields

policy_id string - The ID of the retention policy to assign

assign_to RetentionPolicyAssignmentsAssignTo - The item to assign the policy to

box: RetentionpolicyBase

The bare basic representation of a file version, the minimal amount of fields returned when using the fields query parameter.

Fields

id string? - The unique identifier that represent a file version.

'type string? - retention_policy

box: RetentionpolicyMini

A mini representation of a retention policy, used when nested within another resource.

Fields

Fields Included from *RetentionpolicyBase

id string
type string
anydata...

policy_name string? - The name given to the retention policy

retention_length string? - The length of the retention policy. This length specifies the duration in days that the retention policy will be active for after being assigned to content. If the policy has A policy_type of indefinite, the retention_length will also be indefinite.

disposition_action string? - The disposition action of the retention policy. This action can be permanently_delete, which will cause the content retained by the policy to be permanently deleted, or remove_retention, which will lift the retention policy from the content, allowing it to be deleted by users, once the retention policy has expired.

box: SearchResults

A list of files, folders and web links that matched the search query.

Fields

total_count int? - One greater than the offset of the last entry in the search results. The total number of entries in the collection may be less than total_count.

'limit int? - The limit that was used for this search. This will be the same as the limit query parameter unless that value exceeded the maximum value allowed.

offset int? - The 0-based offset of the first entry in this set. This will be the same as the offset query parameter used.

entries (File|Folder|WebLink)[]? - The search results for the query provided.

box: SearchResultsWithSharedLinks

A list of files, folders and web links that matched the search query, including the additional information about any shared links through which the item has been shared with the user. This response format is only returned when the include_recent_shared_links query parameter has been set to true.

Fields

total_count int? - One greater than the offset of the last entry in the search results. The total number of entries in the collection may be less than total_count.

'limit int? - The limit that was used for this search. This will be the same as the limit query parameter unless that value exceeded the maximum value allowed.

offset int? - The 0-based offset of the first entry in this set. This will be the same as the offset query parameter used.

entries SearchResultWithSharedLink[]? - The search results for the query provided, including the additional information about any shared links through which the item has been shared with the user.

box: SearchResultWithSharedLink

A single of files, folder or web link that matched the search query, including the additional information about the shared link through which the item has been shared with the user. This response format is only returned when the include_recent_shared_links query parameter has been set to true.

Fields

accessible_via_shared_link string? - The optional shared link through which the user has access to this item. This value is only returned for items for which the user has recently accessed the file through a shared link. For all other items this value will return null.

item File|Folder|WebLink? -

'type string? - The result type. The value is always search_result.

box: SessionEndpoint

Session endpoints.

Fields

upload_part string? - The URL to upload parts to

'commit string? - The URL used to commit the file

abort string? - The URL for used to abort the session.

list_parts string? - The URL users to list all parts.

status string? - The URL used to get the status of the upload.

log_event string? - The URL used to get the upload log from.

box: Skill

An object representing a skill

Fields

id string? - The unique identifier for this skill

'type string? - skill

name string? - The name of the skill

api_key string? - The client ID of the application

box: SkillCard

A generic Box Skill metadata card.

Fields

created_at string? - The optional date and time this card was created at.

'type string - skill_card

skill_card_type string - The type of card to add to the file.

skill_card_title SkillcardSkillCardTitle? - The title of the card.

status SkillcardStatus? - Used with a card of type status to set the status of the skill. This can be used to show a message to the user while the Skill is processing the data.

skill SkillcardSkill - The service that applied this metadata.

invocation SkillcardInvocation - The invocation of this service, used to track which instance of a service applied the metadata.

duration int? - An optional total duration in seconds. Used with a skill_card_type of transcript or timeline.

entries SkillcardEntries[]? - An optional list of entries in the metadata card. This field is used with a skill_card_type of transcript, keyword or timeline.

box: SkillcardAppears

The timestamp for an entry.

Fields

'start int? - The time in seconds when an entry should start appearing on a timeline.

end int? - The time in seconds when an entry should stop appearing on a timeline. For a skill_card_type of transcript this value is ignored.

box: SkillcardEntries

An entry in the entries attribute of a metadata card

Fields

text string? - The text of the entry. This would be the actual keyword in a keyword card, the line of a transcript in a transcript card, or the display name for an item when using the timeline entry.

appears SkillcardAppears[]? - Defines a list of timestamps for an entry. This is used with a skill_card_type of transcript as well as timeline to place items on a timeline. For a skill_card_type of transcript there can only be one entry in this list for each item, and only the start time is used to place the transcript on the timeline.

image_url string? - The image to show on a for an entry that appears on a timeline. This image URL is required for any timeline cards. The image will be shown in a list of items (for example faces), and clicking the image will show the user where that entry appears during the duration of this entry.

box: SkillcardInvocation

The invocation of this service, used to track which instance of a service applied the metadata.

Fields

'type string - skill_invocation

id string - A custom identifier that represent the instance of the service that applied this metadata. For example, if your image-recognition-service runs on multiple nodes, this field can be used to identify the ID of the node that was used to apply the metadata.

box: SkillcardSkill

The service that applied this metadata.

Fields

'type string - service

id string - A custom identifier that represent the service that applied this metadata.

box: SkillcardSkillCardTitle

The title of the card.

Fields

code string? - An optional identifier for the title.

message string - The actual title to show in the UI.

box: SkillcardStatus

Used with a card of type status to set the status of the skill. This can be used to show a message to the user while the Skill is processing the data.

Fields

code string - A code for the status of this Skill invocation. By default each of these will have their own accompanied messages. These can be adjusted by setting the message value on this object.

message string? - A custom message that can be provided with this status. This will be shown in the web app to the end user.

box: SkillInvocation

The payload of a Box skill as sent to a skill's invocation_url.

Fields

'type string? - skill_invocation

id string? - Unique identifier for the invocation request.

skill Skill? - An object representing a skill

token SkillinvocationToken? - The read-only and read-write access tokens for this item

status SkillinvocationStatus? - The details status of this event.

created_at string? - The time this invocation was created.

trigger string? - Action that triggered the invocation

enterprise Enterprise? - A representation of a Box enterprise

'source File|Folder? -

event Event? - The description of an event that happened within Box

box: SkillInvocationsSkillIdBody

Fields

status string - Defines the status of this invocation. Set this to success when setting Skill cards.

metadata SkillInvocationsskillIdMetadata - The metadata to set for this skill. This is a list of Box Skills cards. These cards will overwrite any existing Box skill cards on the file.

file SkillInvocationsskillIdFile - The file to assign the cards to.

file_version SkillInvocationsskillIdFileVersion? - The optional file version to assign the cards to.

usage SkillInvocationsskillIdUsage? - A descriptor that defines what items are affected by this call. Set this to the default values when setting a card to a success state, and leave it out in most other situations.

box: SkillInvocationsskillIdFile

The file to assign the cards to.

Fields

'type string? - file

id string? - The ID of the file

box: SkillInvocationsskillIdFileVersion

The optional file version to assign the cards to.

Fields

'type string? - file_version

id string? - The ID of the file version

box: SkillInvocationsskillIdMetadata

The metadata to set for this skill. This is a list of Box Skills cards. These cards will overwrite any existing Box skill cards on the file.

Fields

cards (SkillCard|KeywordSkillCard|TimelineSkillCard|TranscriptSkillCard|StatusSkillCard)[]? - A list of Box Skill cards to apply to this file.

box: SkillInvocationsskillIdUsage

A descriptor that defines what items are affected by this call. Set this to the default values when setting a card to a success state, and leave it out in most other situations.

Fields

unit string? - file

value decimal? - 1

box: SkillinvocationStatus

The details status of this event.

Fields

state string? - The state of this event. * invoked - Triggered the skill with event details to start applying skill on the file. * processing - Currently processing. * success - Completed processing with a success. * transient_failure - Encountered an issue which can be retried. * permanent_failure - Encountered a permanent issue and retry would not help.

message string? - Status information

error_code string? - Error code information, if error occurred.

additional_info string? - Additional status information.

box: SkillinvocationToken

The read-only and read-write access tokens for this item

Fields

read SkillinvocationTokenRead? - The basics of an access token

write SkillinvocationTokenRead? - The basics of an access token

box: SkillinvocationTokenRead

The basics of an access token

Fields

access_token string? - The requested access token.

expires_in int? - The time in seconds in seconds by which this token will expire.

token_type string? - The type of access token returned.

restricted_to FileScope[]? - The permissions that this access token permits, providing a list of resources (files, folders, etc) and the scopes permitted for each of those resources.

box: StatusSkillCard

A Box Skill metadata card that puts a status message in the metadata sidebar.

Fields

created_at string? - The optional date and time this card was created at.

'type string - skill_card

skill_card_type string - status

skill_card_title StatusskillcardSkillCardTitle? - The title of the card.

status StatusskillcardStatus - Sets the status of the skill. This can be used to show a message to the user while the Skill is processing the data, or if it was not able to process the file.

skill SkillcardSkill - The service that applied this metadata.

invocation SkillcardInvocation - The invocation of this service, used to track which instance of a service applied the metadata.

box: StatusskillcardSkillCardTitle

The title of the card.

Fields

code string? - An optional identifier for the title.

message string - The actual title to show in the UI.

box: StatusskillcardStatus

Sets the status of the skill. This can be used to show a message to the user while the Skill is processing the data, or if it was not able to process the file.

Fields

code string - A code for the status of this Skill invocation. By default each of these will have their own accompanied messages. These can be adjusted by setting the message value on this object.

message string? - A custom message that can be provided with this status. This will be shown in the web app to the end user.

box: StoragePolicies

A list of storage policies.

Fields

'limit int? - The limit that was used for these entries. This will be the same as the limit query parameter unless that value exceeded the maximum value allowed. The maximum value varies by API.

next_marker int? - The marker for the start of the next page of results.

prev_marker int? - The marker for the start of the previous page of results.

entries StoragePolicy[]? -

box: StoragePolicy

The Storage Policy object describes the storage zone.

Fields

Fields Included from *StoragepolicyMini

id string
type string
anydata...

name string? - A descriptive name of the region

box: StoragePolicyAssignment

The assignment of a storage policy to a user or enterprise

Fields

storage_policy StoragepolicyMini? - A mini description of a Storage Policy object

assigned_to AssignedTo? - The bare basic reference for an object

box: StoragePolicyAssignments

A list of storage policy assignments.

Fields

'limit int? - The limit that was used for these entries. This will be the same as the limit query parameter unless that value exceeded the maximum value allowed. The maximum value varies by API.

next_marker int? - The marker for the start of the next page of results.

prev_marker int? - The marker for the start of the previous page of results.

entries StoragePolicyAssignment[]? -

box: StoragePolicyAssignmentsAssignedTo

The user or enterprise to assign the storage policy to.

Fields

'type string - The type to assign the policy to.

id string - The ID of the user or enterprise

box: StoragePolicyAssignmentsBody

Fields

storage_policy StoragePolicyAssignmentsStoragePolicy - The storage policy to assign to the user or enterprise

assigned_to StoragePolicyAssignmentsAssignedTo - The user or enterprise to assign the storage policy to.

box: StoragePolicyAssignmentsStoragePolicy

The storage policy to assign to the user or enterprise

Fields

'type string - The type to assign.

id string - The ID of the storage policy to assign.

box: StoragePolicyAssignmentsStoragePolicyAssignmentIdBody

Fields

storage_policy StoragePolicyAssignmentsStoragePolicy - The storage policy to assign to the user or enterprise

box: StoragepolicyMini

A mini description of a Storage Policy object

Fields

id string? - The unique identifier for this storage policy

'type string? - storage_policy

box: Task

A task allows for file-centric workflows within Box. Users can create tasks on files and assign them to other users for them to complete the tasks.

Fields

id string? - The unique identifier for this task

'type string? - task

item FileMini? - A mini representation of a file, used when nested under another resource.

due_at string? - When the task is due

action string? - The type of task the task assignee will be prompted to perform.

message string? - A message that will be included with the task

task_assignment_collection TaskAssignments? - A list of task assignments

is_completed boolean? - Whether the task has been completed

created_by UserMini? - A mini representation of a user, as can be returned when nested within other resources.

created_at string? - When the task object was created

completion_rule string? - Defines which assignees need to complete this task before the task is considered completed. * all_assignees requires all assignees to review or approve the the task in order for it to be considered completed. * any_assignee accepts any one assignee to review or approve the the task in order for it to be considered completed.

box: TaskAssignment

A task assignment defines which task is assigned to which user to complete.

Fields

id string? - The unique identifier for this task assignment

'type string? - task_assignment

item FileMini? - A mini representation of a file, used when nested under another resource.

assigned_to UserMini? - A mini representation of a user, as can be returned when nested within other resources.

message string? - A message that will is included with the task assignment. This is visible to the assigned user in the web and mobile UI.

completed_at string? - The date at which this task assignment was completed. This will be null if the task is not completed yet.

assigned_at string? - The date at which this task was assigned to the user.

reminded_at string? - The date at which the assigned user was reminded of this task assignment.

resolution_state string? - The current state of the assignment. The available states depend on the action value of the task object.

assigned_by UserMini? - A mini representation of a user, as can be returned when nested within other resources.

box: TaskAssignments

A list of task assignments

Fields

total_count int? - The total number of items in this collection.

entries TaskAssignment[]? - The entries of task assignments.

box: TaskAssignmentsAssignTo

The user to assign the task to.

Fields

id string? - The ID of the user to assign to the task. To specify a user by their email address use the login parameter.

box: TaskAssignmentsBody

Fields

task TaskAssignmentsTask - The task to assign to a user.

assign_to TaskAssignmentsAssignTo - The user to assign the task to.

box: TaskAssignmentsTask

The task to assign to a user.

Fields

id string - The ID of the task

'type string - The type of the item to assign.

box: TaskAssignmentsTaskAssignmentIdBody

Fields

message string? - An optional message by the assignee that can be added to the task.

resolution_state string? - The state of the task assigned to the user. * For a task with an action value of complete this can be incomplete or completed. * For a task with an action of review this can be incomplete, approved, or rejected.

box: Tasks

A list of tasks

Fields

total_count int? - One greater than the offset of the last entry in the entire collection. The total number of entries in the collection may be less than total_count.

entries Task[]? - Tasks on files which other users can to complete for a user.

box: TasksBody

Fields

item TasksItem - The file to attach the task to.

action string(default "review") - The action the task assignee will be prompted to do. Must be * review defines an approval task that can be approved or rejected * complete defines a general task which can be completed

message string(default "") - An optional message to include with the task.

due_at string? - Defines when the task is due. Defaults to null if not provided.

completion_rule string(default "all_assignees") - Defines which assignees need to complete this task before the task is considered completed. * all_assignees (default) requires all assignees to review or approve the the task in order for it to be considered completed. * any_assignee accepts any one assignee to review or approve the the task in order for it to be considered completed.

box: TasksItem

The file to attach the task to.

Fields

id string - The ID of the file

'type string - file

box: TasksTaskIdBody

Fields

action string? - The action the task assignee will be prompted to do. Must be * review defines an approval task that can be approved or rejected * complete defines a general task which can be completed

message string? - The message included with the task.

due_at string? - When the task is due at.

completion_rule string? - Defines which assignees need to complete this task before the task is considered completed. * all_assignees (default) requires all assignees to review or approve the the task in order for it to be considered completed. * any_assignee accepts any one assignee to review or approve the the task in order for it to be considered completed.

box: TermsOfService

The root-level record that is supposed to represent a single Terms of Service.

Fields

Fields Included from *TermsofserviceMini

id string
type string
anydata...

status string? - Whether these terms are enabled or not

enterprise record { id string, 'type string, name string }? -

tos_type string? - Whether to apply these terms to managed users or external users

text string? - The text for your terms and conditions. This text could be empty if the status is set to disabled.

created_at string? - When the legal item was created

modified_at string? - When the legal item was modified.

box: TermsofserviceMini

The root-level record that is supposed to represent a single Terms of Service.

Fields

id string? - The unique identifier for this terms of service.

'type string? - terms_of_service

box: TermsOfServices

A list of terms of services

Fields

total_count int? - The total number of objects.

entries TermsOfService[]? - The entries of terms of service.

box: TermsOfServicesBody

Fields

status string - Whether this terms of service is active.

tos_type string? - The type of user to set the terms of service for.

text string - The terms of service text to display to users. The text can be set to empty if the status is set to disabled.

box: TermsOfServicesTermsOfServiceIdBody

Fields

status string - Whether this terms of service is active.

text string - The terms of service text to display to users. The text can be set to empty if the status is set to disabled.

box: TermsOfServiceUserStatus

The association between a Terms of Service and a user

Fields

id string? - The unique identifier for this terms of service user status

'type string? - terms_of_service_user_status

tos TermsofserviceMini? - The root-level record that is supposed to represent a single Terms of Service.

user UserMini? - A mini representation of a user, as can be returned when nested within other resources.

is_accepted boolean? - If the user has accepted the terms of services

created_at string? - When the legal item was created

modified_at string? - When the legal item was modified.

box: TermsOfServiceUserStatuses

A list of terms of service user statuses

Fields

total_count int? - The total number of objects.

entries TermsOfServiceUserStatus[]? - The associations between a Terms of Service and a user.

box: TermsOfServiceUserStatusesBody

Fields

tos TermsOfServiceUserStatusesTos - The terms of service to set the status for.

user TermsOfServiceUserStatusesUser - The user to set the status for.

is_accepted boolean - Whether the user has accepted the terms.

box: TermsOfServiceUserStatusesTermsOfServiceUserStatusIdBody

Fields

is_accepted boolean - Whether the user has accepted the terms.

box: TermsOfServiceUserStatusesTos

The terms of service to set the status for.

Fields

'type string - The type of object.

id string - The ID of terms of service

box: TermsOfServiceUserStatusesUser

The user to set the status for.

Fields

'type string - The type of object.

id string - The ID of user

box: TimelineSkillCard

A Box Skill metadata card that places a list of images on a timeline.

Fields

created_at string? - The optional date and time this card was created at.

'type string - skill_card

skill_card_type string - timeline

skill_card_title TimelineskillcardSkillCardTitle? - The title of the card.

skill SkillcardSkill - The service that applied this metadata.

invocation SkillcardInvocation - The invocation of this service, used to track which instance of a service applied the metadata.

duration int? - An total duration in seconds of the timeline.

entries TimelineskillcardEntries[] - A list of entries on the timeline.

box: TimelineskillcardAppears

The timestamp for an entry.

Fields

'start int? - The time in seconds when an entry should start appearing on a timeline.

end int? - The time in seconds when an entry should stop appearing on a timeline.

box: TimelineskillcardEntries

An single item that's placed on multiple items on the timeline.

Fields

text string? - The text of the entry. This would be the display name for an item being placed on the timeline, for example the name of the person who was detected in a video.

appears TimelineskillcardAppears[]? - Defines a list of timestamps for when this item should appear on the timeline.

image_url string? - The image to show on a for an entry that appears on a timeline. This image URL is required for every entry. The image will be shown in a list of items (for example faces), and clicking the image will show the user where that entry appears during the duration of this entry.

box: TimelineskillcardSkillCardTitle

The title of the card.

Fields

code string? - An optional identifier for the title.

message string - The actual title to show in the UI.

box: TranscriptSkillCard

A Box Skill metadata card that adds a transcript to a file.

Fields

created_at string? - The optional date and time this card was created at.

'type string - skill_card

skill_card_type string - transcript

skill_card_title SkillcardSkillCardTitle? - The title of the card.

skill TranscriptskillcardSkill - The service that applied this metadata.

invocation TranscriptskillcardInvocation - The invocation of this service, used to track which instance of a service applied the metadata.

duration int? - An optional total duration in seconds. Used with a skill_card_type of transcript or timeline.

entries TranscriptskillcardEntries[] - An list of entries for the card. This represents the individual entries of the transcription.

box: TranscriptskillcardAppears

The timestamp for an entry.

Fields

'start int? - The time in seconds when an entry should start appearing on a timeline.

box: TranscriptskillcardEntries

An entry in the entries attribute of a metadata card

Fields

text string? - The text of the entry. This would be the transcribed text assigned to the entry on the timeline.

appears TranscriptskillcardAppears[]? - Defines when a transcribed bit of text appears. This only includes a start time and no end time.

box: TranscriptskillcardInvocation

The invocation of this service, used to track which instance of a service applied the metadata.

Fields

'type string - skill_invocation

id string - A custom identifier that represent the instance of the service that applied this metadata. For example, if your image-recognition-service runs on multiple nodes, this field can be used to identify the ID of the node that was used to apply the metadata.

box: TranscriptskillcardSkill

The service that applied this metadata.

Fields

'type string - service

id string - A custom identifier that represent the service that applied this metadata.

box: UploadedPart

A chunk of a file uploaded as part of an upload session, as returned by some endpoints.

Fields

part UploadPart? - The representation of an upload session chunk.

box: UploadPart

The representation of an upload session chunk.

Fields

Fields Included from *UploadpartMini

part_id string
offset int
size int
anydata...

sha1 string? - The SHA1 hash of the chunk.

box: UploadpartMini

The basic representation of an upload session chunk.

Fields

part_id string? - The unique ID of the chunk.

offset int? - The offset of the chunk within the file in bytes. The lower bound of the position of the chunk within the file.

size int? - The size of the chunk in bytes.

box: UploadParts

A list of uploaded chunks for an upload session.

Fields

total_count int? - One greater than the offset of the last entry in the entire collection. The total number of entries in the collection may be less than total_count. This field is only returned for calls that use offset-based pagination. For marker-based paginated APIs, this field will be omitted.

'limit int? - The limit that was used for these entries. This will be the same as the limit query parameter unless that value exceeded the maximum value allowed. The maximum value varies by API.

offset int? - The 0-based offset of the first entry in this set. This will be the same as the offset query parameter. This field is only returned for calls that use offset-based pagination. For marker-based paginated APIs, this field will be omitted.

'order CollaborationsOrder[]? - The order by which items are returned. This field is only returned for calls that use offset-based pagination. For marker-based paginated APIs, this field will be omitted.

entries UploadPart[]? -

box: UploadSession

An upload session for chunk uploading a file.

Fields

id string? - The unique identifier for this session

'type string? - upload_session

session_expires_at string? - The date and time when this session expires.

part_size int? - The size in bytes that must be used for all parts of of the upload. Only the last part is allowed to be of a smaller size.

total_parts int? - The total number of parts expected in this upload session, as determined by the file size and part size.

num_parts_processed int? - The number of parts that have been uploaded and processed by the server. This starts at 0. When committing a file files, inspecting this property can provide insight if all parts have been uploaded correctly.

session_endpoints SessionEndpoint? - Session endpoints.

box: UploadSessionIdCommitBody

Fields

parts UploadPart[] - The list details for the uploaded parts

box: UploadUrl

The details for the upload session for the file.

Fields

upload_url string? - A URL for an upload session that can be used to upload the file.

upload_token string? - An optional access token to use to upload the file

box: User

A standard representation of a user, as returned from any user API endpoints by default

Fields

Fields Included from *UserMini

name string
login string
id string
type string
anydata...

created_at string? - When the user object was created

modified_at string? - When the user object was last modified

language string? - The language of the user, formatted in modified version of the ISO 639-1 format.

timezone string? - The user's timezone

space_amount int? - The user’s total available space amount in bytes

space_used int? - The amount of space in use by the user

max_upload_size int? - The maximum individual file size in bytes the user can have

status string? - The user's account status

job_title string? - The user’s job title

phone string? - The user’s phone number

address string? - The user’s address

avatar_url string? - URL of the user’s avatar image

notification_email UserNotificationEmail? - An alternate notification email address to which email notifications are sent. When it's confirmed, this will be the email address to which notifications are sent instead of to the primary email address.

clients

records

ballerinax/box Ballerina library

Overview

Prerequisites

Quickstart

Step 1: Import connector

Step 2: Create a new connector instance

Step 3: Invoke connector operation

Clients

box: Client

Constructor

getAuthorize

Parameters

Return Type

postOauth2Token

Parameters

Return Type

postOauth2TokenRefresh

Parameters

Return Type

postOauth2Revoke

Parameters

Return Type

getFilesId

Parameters

Return Type

putFilesId

Parameters

Return Type

postFilesId

Parameters

Return Type

deleteFilesId

Parameters

Return Type

getFilesIdContent

Parameters

Return Type

postFilesIdContent

Parameters

Return Type

postFilesContent

Parameters

Return Type

postFilesUploadSessions

Parameters

Return Type

postFilesIdUploadSessions

Parameters

Return Type

getFilesUploadSessionsId

Parameters

Return Type

putFilesUploadSessionsId

Parameters

Return Type

deleteFilesUploadSessionsId

Parameters

Return Type

getFilesUploadSessionsIdParts

Parameters

Return Type

postFilesUploadSessionsIdCommit

Parameters

Return Type

postFilesIdCopy

Parameters

Return Type

getFilesIdThumbnailId

Parameters

Return Type

getFilesIdCollaborations

Parameters

Return Type

getFilesIdComments

Parameters

Return Type

getFilesIdTasks

Parameters