Module files.com

ballerinax/files.com Ballerina library

1.5.1

Overview

This is a generated connector from Files.com API v1.0 OpenAPI specification.

Welcome to the Files.com API. Our REST API are designed for people who require the highest level of integration between Files.com and their own application, website, or database.

Prerequisites

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

Create a Files.com account
Obtain tokens by following this guide

Quickstart

To use the Files.com connector in your Ballerina application, update the .bal file as follows:

Step 1: Import connector

First, import the ballerinax/files.com module into the Ballerina project.


import ballerinax/files.com as filesdotcom;

Step 2: Create a new connector instance

Create a filesdotcom:ClientConfig with the API key obtained, and initialize the connector with it.


filesdotcom:ClientConfig clientConfig = {
    authConfig : {
        token: <ACCESS_TOKEN>
    }
};

filesdotcom:Client baseClient = check new Client(clientConfig);

Step 3: Invoke connector operation

Now you can use the operations available within the connector. Note that they are in the form of remote operations.

Following is an example on how to get API activity using the connector.


public function main() {
    filesdotcom:SiteEntity|error response = baseClient->getSite();
    if (response is filesdotcom:SiteEntity) {
        log:printInfo(response.toString());
    } else {
        log:printError(response.message());
    }
}

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

Clients

files.com: Client

Isolated

This is a generated connector from Files.com API v1.0 OpenAPI specification. Welcome to the Files.com API. Our REST API are designed for people who require the highest level of integration between Files.com and their own application, website, or database.

Constructor

Gets invoked to initialize the connector. The connector initialization requires setting the API credentials. Obtain API keys following this guide.

init (ApiKeysConfig apiKeyConfig, string serviceUrl, ConnectionConfig config)

apiKeyConfig ApiKeysConfig - API keys for authorization

serviceUrl string - URL of the target service

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

postActionNotificationExports

Isolated FunctionRemote Function

function postActionNotificationExports(ActionNotificationExportsBody payload) returns ActionNotificationExportEntity|error

Create Action Notification Export

Parameters

payload ActionNotificationExportsBody -

Return Type

ActionNotificationExportEntity|error - The ActionNotificationExports object.

getActionNotificationExportsId

Isolated FunctionRemote Function

function getActionNotificationExportsId(int id) returns ActionNotificationExportEntity|error

Show Action Notification Export

Parameters

id int - Action Notification Export ID.

Return Type

ActionNotificationExportEntity|error - The ActionNotificationExports object.

getActionNotificationExportResults

Isolated FunctionRemote Function

function getActionNotificationExportResults(int actionNotificationExportId, int? userId, string? cursor, int? perPage) returns ActionNotificationExportResultEntity[]|error

List Action Notification Export Results

Parameters

actionNotificationExportId int - ID of the associated action notification export.

userId int? (default ()) - User ID. Provide a value of 0 to operate the current session's user.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

Return Type

ActionNotificationExportResultEntity[]|error - A list of ActionNotificationExportResults objects.

postActionWebhookFailuresIdRetry

Isolated FunctionRemote Function

function postActionWebhookFailuresIdRetry(int id) returns Response|error

retry Action Webhook Failure

Parameters

id int - Action Webhook Failure ID.

Return Type

Response|error - The ActionWebhookFailures object.

apiKeyFindCurrent

Isolated FunctionRemote Function

function apiKeyFindCurrent() returns ApiKeyEntity|error

Show information about current API key. (Requires current API connection to be using an API key.)

Return Type

ApiKeyEntity|error - The ApiKey object.

apiKeyDeleteCurrent

Isolated FunctionRemote Function

function apiKeyDeleteCurrent() returns Response|error

Delete current API key. (Requires current API connection to be using an API key.)

Return Type

Response|error - No body.

apiKeyUpdateCurrent

Isolated FunctionRemote Function

function apiKeyUpdateCurrent(ApiKeyBody payload) returns ApiKeyEntity|error

Update current API key. (Requires current API connection to be using an API key.)

Parameters

payload ApiKeyBody -

Return Type

ApiKeyEntity|error - The ApiKey object.

getApiKeysId

Isolated FunctionRemote Function

function getApiKeysId(int id) returns ApiKeyEntity|error

Show Api Key

Parameters

id int - Api Key ID.

Return Type

ApiKeyEntity|error - The ApiKeys object.

deleteApiKeysId

Isolated FunctionRemote Function

function deleteApiKeysId(int id) returns Response|error

Delete Api Key

Parameters

id int - Api Key ID.

Return Type

Response|error - No body.

patchApiKeysId

Isolated FunctionRemote Function

function patchApiKeysId(int id, ApiKeysIdBody payload) returns ApiKeyEntity|error

Update Api Key

Parameters

id int - Api Key ID.

payload ApiKeysIdBody -

Return Type

ApiKeyEntity|error - The ApiKeys object.

getApiKeys

Isolated FunctionRemote Function

function getApiKeys(int? userId, string? cursor, int? perPage, record {}? sortBy, record {}? filter, record {}? filterGt, record {}? filterGteq, record {}? filterLike, record {}? filterLt, record {}? filterLteq) returns ApiKeyEntity[]|error

List Api Keys

Parameters

userId int? (default ()) - User ID. Provide a value of 0 to operate the current session's user.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

sortBy record {}? (default ()) - If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are expires_at.

filter record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are expires_at.

filterGt record {}? (default ()) - If set, return records where the specifiied field is greater than the supplied value. Valid fields are expires_at.

filterGteq record {}? (default ()) - If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are expires_at.

filterLike record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are expires_at.

filterLt record {}? (default ()) - If set, return records where the specifiied field is less than the supplied value. Valid fields are expires_at.

filterLteq record {}? (default ()) - If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are expires_at.

Return Type

ApiKeyEntity[]|error - A list of ApiKeys objects.

postApiKeys

Isolated FunctionRemote Function

function postApiKeys(ApiKeysBody payload) returns ApiKeyEntity|error

Create Api Key

Parameters

payload ApiKeysBody -

Return Type

ApiKeyEntity|error - The ApiKeys object.

getSiteUsage

Isolated FunctionRemote Function

function getSiteUsage() returns UsageSnapshotEntity|error

Get the most recent usage snapshot (usage data for billing purposes) for a Site.

Return Type

UsageSnapshotEntity|error - The Site object.

getSite

Isolated FunctionRemote Function

function getSite() returns SiteEntity|error

Show site settings

Return Type

SiteEntity|error - The Site object.

patchSite

Isolated FunctionRemote Function

function patchSite(SiteBody payload) returns SiteEntity|error

Update site settings.

Parameters

payload SiteBody -

Return Type

SiteEntity|error - The Site object.

getSiteIpAddresses

Isolated FunctionRemote Function

function getSiteIpAddresses(string? cursor, int? perPage) returns IpAddressEntity[]|error

List IP Addresses associated with the current site

Parameters

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

Return Type

IpAddressEntity[]|error - A list of IpAddresses objects.

getSiteDnsRecords

Isolated FunctionRemote Function

function getSiteDnsRecords(string? cursor, int? perPage) returns DnsRecordEntity[]|error

Show site DNS configuration.

Parameters

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

Return Type

DnsRecordEntity[]|error - A list of DnsRecords objects.

postSiteTestWebhook

Isolated FunctionRemote Function

function postSiteTestWebhook(SiteTestwebhookBody payload) returns StatusEntity|error

Test webhook.

Parameters

payload SiteTestwebhookBody -

Return Type

StatusEntity|error - The Behaviors object.

getSiteApiKeys

Isolated FunctionRemote Function

function getSiteApiKeys(int? userId, string? cursor, int? perPage, record {}? sortBy, record {}? filter, record {}? filterGt, record {}? filterGteq, record {}? filterLike, record {}? filterLt, record {}? filterLteq) returns ApiKeyEntity[]|error

List Api Keys

Parameters

userId int? (default ()) - User ID. Provide a value of 0 to operate the current session's user.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

sortBy record {}? (default ()) - If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are expires_at.

filter record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are expires_at.

filterGt record {}? (default ()) - If set, return records where the specifiied field is greater than the supplied value. Valid fields are expires_at.

filterGteq record {}? (default ()) - If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are expires_at.

filterLike record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are expires_at.

filterLt record {}? (default ()) - If set, return records where the specifiied field is less than the supplied value. Valid fields are expires_at.

filterLteq record {}? (default ()) - If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are expires_at.

Return Type

ApiKeyEntity[]|error - A list of ApiKeys objects.

postSiteApiKeys

Isolated FunctionRemote Function

function postSiteApiKeys(SiteApiKeysBody payload) returns ApiKeyEntity|error

Create Api Key

Parameters

payload SiteApiKeysBody -

Return Type

ApiKeyEntity|error - The ApiKeys object.

patchUser

Isolated FunctionRemote Function

function patchUser(UserBody payload) returns UserEntity|error

Update User

Parameters

payload UserBody -

Return Type

UserEntity|error - The Users object.

getUserPublicKeys

Isolated FunctionRemote Function

function getUserPublicKeys(int? userId, string? cursor, int? perPage) returns PublicKeyEntity[]|error

List Public Keys

Parameters

userId int? (default ()) - User ID. Provide a value of 0 to operate the current session's user.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

Return Type

PublicKeyEntity[]|error - A list of PublicKeys objects.

postUserPublicKeys

Isolated FunctionRemote Function

function postUserPublicKeys(UserPublicKeysBody payload) returns PublicKeyEntity|error

Create Public Key

Parameters

payload UserPublicKeysBody -

Return Type

PublicKeyEntity|error - The PublicKeys object.

getUserGroups

Isolated FunctionRemote Function

function getUserGroups(int? userId, string? cursor, int? perPage, int? groupId) returns GroupUserEntity[]|error

List Group Users

Parameters

userId int? (default ()) - User ID. If provided, will return group_users of this user.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

groupId int? (default ()) - Group ID. If provided, will return group_users of this group.

Return Type

GroupUserEntity[]|error - A list of GroupUsers objects.

getUserAs2Keys

Isolated FunctionRemote Function

function getUserAs2Keys(int? userId, string? cursor, int? perPage) returns As2KeyEntity[]|error

List As2 Keys

Parameters

userId int? (default ()) - User ID. Provide a value of 0 to operate the current session's user.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

Return Type

As2KeyEntity[]|error - A list of As2Keys objects.

postUserAs2Keys

Isolated FunctionRemote Function

function postUserAs2Keys(UserAs2KeysBody payload) returns As2KeyEntity|error

Create As2 Key

Parameters

payload UserAs2KeysBody -

Return Type

As2KeyEntity|error - The As2Keys object.

getUserApiKeys

Isolated FunctionRemote Function

function getUserApiKeys(int? userId, string? cursor, int? perPage, record {}? sortBy, record {}? filter, record {}? filterGt, record {}? filterGteq, record {}? filterLike, record {}? filterLt, record {}? filterLteq) returns ApiKeyEntity[]|error

List Api Keys

Parameters

userId int? (default ()) - User ID. Provide a value of 0 to operate the current session's user.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

sortBy record {}? (default ()) - If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are expires_at.

filter record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are expires_at.

filterGt record {}? (default ()) - If set, return records where the specifiied field is greater than the supplied value. Valid fields are expires_at.

filterGteq record {}? (default ()) - If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are expires_at.

filterLike record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are expires_at.

filterLt record {}? (default ()) - If set, return records where the specifiied field is less than the supplied value. Valid fields are expires_at.

filterLteq record {}? (default ()) - If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are expires_at.

Return Type

ApiKeyEntity[]|error - A list of ApiKeys objects.

postUserApiKeys

Isolated FunctionRemote Function

function postUserApiKeys(UserApiKeysBody payload) returns ApiKeyEntity|error

Create Api Key

Parameters

payload UserApiKeysBody -

Return Type

ApiKeyEntity|error - The ApiKeys object.

postUsersIdUnlock

Isolated FunctionRemote Function

function postUsersIdUnlock(int id) returns Response|error

Unlock user who has been locked out due to failed logins.

Parameters

id int - User ID.

Return Type

Response|error - No body.

postUsersIdResendWelcomeEmail

Isolated FunctionRemote Function

function postUsersIdResendWelcomeEmail(int id) returns Response|error

Resend user welcome email

Parameters

id int - User ID.

Return Type

Response|error - No body.

postUsersId2faReset

Isolated FunctionRemote Function

function postUsersId2faReset(int id) returns Response|error

Trigger 2FA Reset process for user who has lost access to their existing 2FA methods.

Parameters

id int - User ID.

Return Type

Response|error - No body.

getUsersId

Isolated FunctionRemote Function

function getUsersId(int id) returns UserEntity|error

Show User

Parameters

id int - User ID.

Return Type

UserEntity|error - The Users object.

deleteUsersId

Isolated FunctionRemote Function

function deleteUsersId(int id) returns Response|error

Delete User

Parameters

id int - User ID.

Return Type

Response|error - No body.

patchUsersId

Isolated FunctionRemote Function

function patchUsersId(int id, UsersIdBody payload) returns UserEntity|error

Update User

Parameters

id int - User ID.

payload UsersIdBody -

Return Type

UserEntity|error - The Users object.

getUsers

Isolated FunctionRemote Function

function getUsers(string? cursor, int? perPage, record {}? sortBy, record {}? filter, record {}? filterGt, record {}? filterGteq, record {}? filterLike, record {}? filterLt, record {}? filterLteq, string? ids, string? qUsername, string? qEmail, string? qNotes, string? qAdmin, string? qAllowedIps, string? qPasswordValidityDays, string? qSslRequired, string? search) returns UserEntity[]|error

List Users

Parameters

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

sortBy record {}? (default ()) - If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are authenticate_until, email, last_desktop_login_at, last_login_at, username, company, name, site_admin, receive_admin_alerts, password_validity_days, ssl_required or not_site_admin.

filter record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are username, email, company, site_admin, password_validity_days, ssl_required, last_login_at, authenticate_until or not_site_admin.

filterGt record {}? (default ()) - If set, return records where the specifiied field is greater than the supplied value. Valid fields are username, email, company, site_admin, password_validity_days, ssl_required, last_login_at, authenticate_until or not_site_admin.

filterGteq record {}? (default ()) - If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are username, email, company, site_admin, password_validity_days, ssl_required, last_login_at, authenticate_until or not_site_admin.

filterLike record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are username, email, company, site_admin, password_validity_days, ssl_required, last_login_at, authenticate_until or not_site_admin.

filterLt record {}? (default ()) - If set, return records where the specifiied field is less than the supplied value. Valid fields are username, email, company, site_admin, password_validity_days, ssl_required, last_login_at, authenticate_until or not_site_admin.

filterLteq record {}? (default ()) - If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are username, email, company, site_admin, password_validity_days, ssl_required, last_login_at, authenticate_until or not_site_admin.

ids string? (default ()) - comma-separated list of User IDs

qUsername string? (default ()) - List users matching username.

qEmail string? (default ()) - List users matching email.

qNotes string? (default ()) - List users matching notes field.

qAdmin string? (default ()) - If true, list only admin users.

qAllowedIps string? (default ()) - If set, list only users with overridden allowed IP setting.

qPasswordValidityDays string? (default ()) - If set, list only users with overridden password validity days setting.

qSslRequired string? (default ()) - If set, list only users with overridden SSL required setting.

search string? (default ()) - Searches for partial matches of name, username, or email.

Return Type

UserEntity[]|error - A list of Users objects.

postUsers

Isolated FunctionRemote Function

function postUsers(UsersBody payload) returns UserEntity|error

Create User

Parameters

payload UsersBody -

Return Type

UserEntity|error - The Users object.

getUsersUserIdCipherUses

Isolated FunctionRemote Function

function getUsersUserIdCipherUses(int userId, string? cursor, int? perPage) returns UserCipherUseEntity[]|error

List User Cipher Uses

Parameters

userId int - User ID. Provide a value of 0 to operate the current session's user.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

Return Type

UserCipherUseEntity[]|error - A list of UserCipherUses objects.

getUsersUserIdPublicKeys

Isolated FunctionRemote Function

function getUsersUserIdPublicKeys(int userId, string? cursor, int? perPage) returns PublicKeyEntity[]|error

List Public Keys

Parameters

userId int - User ID. Provide a value of 0 to operate the current session's user.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

Return Type

PublicKeyEntity[]|error - A list of PublicKeys objects.

postUsersUserIdPublicKeys

Isolated FunctionRemote Function

function postUsersUserIdPublicKeys(int userId, UserIdPublicKeysBody payload) returns PublicKeyEntity|error

Create Public Key

Parameters

userId int - User ID. Provide a value of 0 to operate the current session's user.

payload UserIdPublicKeysBody -

Return Type

PublicKeyEntity|error - The PublicKeys object.

getUsersUserIdPermissions

Isolated FunctionRemote Function

function getUsersUserIdPermissions(string userId, string? cursor, int? perPage, record {}? sortBy, record {}? filter, record {}? filterGt, record {}? filterGteq, record {}? filterLike, record {}? filterLt, record {}? filterLteq, string? groupId, boolean? includeGroups) returns PermissionEntity[]|error

List Permissions

Parameters

userId string - DEPRECATED: User ID. If provided, will scope permissions to this user. Use filter[user_id] instead.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

sortBy record {}? (default ()) - If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are group_id, path, user_id or permission.

filter record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are group_id, user_id or path.

filterGt record {}? (default ()) - If set, return records where the specifiied field is greater than the supplied value. Valid fields are group_id, user_id or path.

filterGteq record {}? (default ()) - If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are group_id, user_id or path.

filterLike record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are group_id, user_id or path.

filterLt record {}? (default ()) - If set, return records where the specifiied field is less than the supplied value. Valid fields are group_id, user_id or path.

filterLteq record {}? (default ()) - If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are group_id, user_id or path.

groupId string? (default ()) - DEPRECATED: Group ID. If provided, will scope permissions to this group. Use filter[group_id] instead.

includeGroups boolean? (default ()) - If searching by user or group, also include user's permissions that are inherited from its groups?

Return Type

PermissionEntity[]|error - A list of Permissions objects.

getUsersUserIdGroups

Isolated FunctionRemote Function

function getUsersUserIdGroups(int userId, string? cursor, int? perPage, int? groupId) returns GroupUserEntity[]|error

List Group Users

Parameters

userId int - User ID. If provided, will return group_users of this user.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

groupId int? (default ()) - Group ID. If provided, will return group_users of this group.

Return Type

GroupUserEntity[]|error - A list of GroupUsers objects.

getUsersUserIdAs2Keys

Isolated FunctionRemote Function

function getUsersUserIdAs2Keys(int userId, string? cursor, int? perPage) returns As2KeyEntity[]|error

List As2 Keys

Parameters

userId int - User ID. Provide a value of 0 to operate the current session's user.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

Return Type

As2KeyEntity[]|error - A list of As2Keys objects.

postUsersUserIdAs2Keys

Isolated FunctionRemote Function

function postUsersUserIdAs2Keys(int userId, UserIdAs2KeysBody payload) returns As2KeyEntity|error

Create As2 Key

Parameters

userId int - User ID. Provide a value of 0 to operate the current session's user.

payload UserIdAs2KeysBody -

Return Type

As2KeyEntity|error - The As2Keys object.

getUsersUserIdApiKeys

Isolated FunctionRemote Function

function getUsersUserIdApiKeys(int userId, string? cursor, int? perPage, record {}? sortBy, record {}? filter, record {}? filterGt, record {}? filterGteq, record {}? filterLike, record {}? filterLt, record {}? filterLteq) returns ApiKeyEntity[]|error

List Api Keys

Parameters

userId int - User ID. Provide a value of 0 to operate the current session's user.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

sortBy record {}? (default ()) - If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are expires_at.

filter record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are expires_at.

filterGt record {}? (default ()) - If set, return records where the specifiied field is greater than the supplied value. Valid fields are expires_at.

filterGteq record {}? (default ()) - If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are expires_at.

filterLike record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are expires_at.

filterLt record {}? (default ()) - If set, return records where the specifiied field is less than the supplied value. Valid fields are expires_at.

filterLteq record {}? (default ()) - If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are expires_at.

Return Type

ApiKeyEntity[]|error - A list of ApiKeys objects.

postUsersUserIdApiKeys

Isolated FunctionRemote Function

function postUsersUserIdApiKeys(int userId, UserIdApiKeysBody payload) returns ApiKeyEntity|error

Create Api Key

Parameters

userId int - User ID. Provide a value of 0 to operate the current session's user.

payload UserIdApiKeysBody -

Return Type

ApiKeyEntity|error - The ApiKeys object.

getApps

Isolated FunctionRemote Function

function getApps(string? cursor, int? perPage, record {}? sortBy, record {}? filter, record {}? filterGt, record {}? filterGteq, record {}? filterLike, record {}? filterLt, record {}? filterLteq) returns AppEntity[]|error

List Apps

Parameters

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

sortBy record {}? (default ()) - If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are name and app_type.

filter record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are name and app_type.

filterGt record {}? (default ()) - If set, return records where the specifiied field is greater than the supplied value. Valid fields are name and app_type.

filterGteq record {}? (default ()) - If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are name and app_type.

filterLike record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are name and app_type.

filterLt record {}? (default ()) - If set, return records where the specifiied field is less than the supplied value. Valid fields are name and app_type.

filterLteq record {}? (default ()) - If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are name and app_type.

Return Type

AppEntity[]|error - A list of Apps objects.

getAs2KeysId

Isolated FunctionRemote Function

function getAs2KeysId(int id) returns As2KeyEntity|error

Show As2 Key

Parameters

id int - As2 Key ID.

Return Type

As2KeyEntity|error - The As2Keys object.

deleteAs2KeysId

Isolated FunctionRemote Function

function deleteAs2KeysId(int id) returns Response|error

Delete As2 Key

Parameters

id int - As2 Key ID.

Return Type

Response|error - No body.

patchAs2KeysId

Isolated FunctionRemote Function

function patchAs2KeysId(int id, As2KeysIdBody payload) returns As2KeyEntity|error

Update As2 Key

Parameters

id int - As2 Key ID.

payload As2KeysIdBody -

Return Type

As2KeyEntity|error - The As2Keys object.

getAs2Keys

Isolated FunctionRemote Function

function getAs2Keys(int? userId, string? cursor, int? perPage) returns As2KeyEntity[]|error

List As2 Keys

Parameters

userId int? (default ()) - User ID. Provide a value of 0 to operate the current session's user.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

Return Type

As2KeyEntity[]|error - A list of As2Keys objects.

postAs2Keys

Isolated FunctionRemote Function

function postAs2Keys(As2KeysBody payload) returns As2KeyEntity|error

Create As2 Key

Parameters

payload As2KeysBody -

Return Type

As2KeyEntity|error - The As2Keys object.

getAutomationsId

Isolated FunctionRemote Function

function getAutomationsId(int id) returns AutomationEntity|error

Show Automation

Parameters

id int - Automation ID.

Return Type

AutomationEntity|error - The Automations object.

deleteAutomationsId

Isolated FunctionRemote Function

function deleteAutomationsId(int id) returns Response|error

Delete Automation

Parameters

id int - Automation ID.

Return Type

Response|error - No body.

patchAutomationsId

Isolated FunctionRemote Function

function patchAutomationsId(int id, AutomationsIdBody payload) returns AutomationEntity|error

Update Automation

Parameters

id int - Automation ID.

payload AutomationsIdBody -

Return Type

AutomationEntity|error - The Automations object.

getAutomations

Isolated FunctionRemote Function

function getAutomations(string? cursor, int? perPage, record {}? sortBy, record {}? filter, record {}? filterGt, record {}? filterGteq, record {}? filterLike, record {}? filterLt, record {}? filterLteq, string? automation) returns AutomationEntity[]|error

List Automations

Parameters

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

sortBy record {}? (default ()) - If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are automation.

filter record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are automation.

filterGt record {}? (default ()) - If set, return records where the specifiied field is greater than the supplied value. Valid fields are automation.

filterGteq record {}? (default ()) - If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are automation.

filterLike record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are automation.

filterLt record {}? (default ()) - If set, return records where the specifiied field is less than the supplied value. Valid fields are automation.

filterLteq record {}? (default ()) - If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are automation.

automation string? (default ()) - DEPRECATED: Type of automation to filter by. Use filter[automation] instead.

Return Type

AutomationEntity[]|error - A list of Automations objects.

postAutomations

Isolated FunctionRemote Function

function postAutomations(AutomationsBody payload) returns AutomationEntity|error

Create Automation

Parameters

payload AutomationsBody -

Return Type

AutomationEntity|error - The Automations object.

getBandwidthSnapshots

Isolated FunctionRemote Function

function getBandwidthSnapshots(string? cursor, int? perPage, record {}? sortBy, record {}? filter, record {}? filterGt, record {}? filterGteq, record {}? filterLike, record {}? filterLt, record {}? filterLteq) returns BandwidthSnapshotEntity[]|error

List Bandwidth Snapshots

Parameters

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

sortBy record {}? (default ()) - If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are logged_at.

filter record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are logged_at.

filterGt record {}? (default ()) - If set, return records where the specifiied field is greater than the supplied value. Valid fields are logged_at.

filterGteq record {}? (default ()) - If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are logged_at.

filterLike record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are logged_at.

filterLt record {}? (default ()) - If set, return records where the specifiied field is less than the supplied value. Valid fields are logged_at.

filterLteq record {}? (default ()) - If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are logged_at.

Return Type

BandwidthSnapshotEntity[]|error - A list of BandwidthSnapshots objects.

postBehaviorsWebhookTest

Isolated FunctionRemote Function

function postBehaviorsWebhookTest(WebhookTestBody payload) returns StatusEntity|error

Test webhook.

Parameters

payload WebhookTestBody -

Return Type

StatusEntity|error - The Behaviors object.

getBehaviorsId

Isolated FunctionRemote Function

function getBehaviorsId(int id) returns BehaviorEntity|error

Show Behavior

Parameters

id int - Behavior ID.

Return Type

BehaviorEntity|error - The Behaviors object.

deleteBehaviorsId

Isolated FunctionRemote Function

function deleteBehaviorsId(int id) returns Response|error

Delete Behavior

Parameters

id int - Behavior ID.

Return Type

Response|error - No body.

patchBehaviorsId

Isolated FunctionRemote Function

function patchBehaviorsId(int id, BehaviorsIdBody payload) returns BehaviorEntity|error

Update Behavior

Parameters

id int - Behavior ID.

payload BehaviorsIdBody -

Return Type

BehaviorEntity|error - The Behaviors object.

getBehaviors

Isolated FunctionRemote Function

function getBehaviors(string? cursor, int? perPage, record {}? sortBy, record {}? filter, record {}? filterGt, record {}? filterGteq, record {}? filterLike, record {}? filterLt, record {}? filterLteq, string? behavior) returns BehaviorEntity[]|error

List Behaviors

Parameters

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

sortBy record {}? (default ()) - If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are behavior.

filter record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are behavior.

filterGt record {}? (default ()) - If set, return records where the specifiied field is greater than the supplied value. Valid fields are behavior.

filterGteq record {}? (default ()) - If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are behavior.

filterLike record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are behavior.

filterLt record {}? (default ()) - If set, return records where the specifiied field is less than the supplied value. Valid fields are behavior.

filterLteq record {}? (default ()) - If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are behavior.

behavior string? (default ()) - If set, only shows folder behaviors matching this behavior type.

Return Type

BehaviorEntity[]|error - A list of Behaviors objects.

postBehaviors

Isolated FunctionRemote Function

function postBehaviors(BehaviorsBody payload) returns BehaviorEntity|error

Create Behavior

Parameters

payload BehaviorsBody -

Return Type

BehaviorEntity|error - The Behaviors object.

behaviorListForPath

Isolated FunctionRemote Function

function behaviorListForPath(string operationPath, string? cursor, int? perPage, record {}? sortBy, record {}? filter, record {}? filterGt, record {}? filterGteq, record {}? filterLike, record {}? filterLt, record {}? filterLteq, string? recursive, string? behavior) returns BehaviorEntity[]|error

List Behaviors by path

Parameters

operationPath string - Path to operate on.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

sortBy record {}? (default ()) - If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are behavior.

filter record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are behavior.

filterGt record {}? (default ()) - If set, return records where the specifiied field is greater than the supplied value. Valid fields are behavior.

filterGteq record {}? (default ()) - If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are behavior.

filterLike record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are behavior.

filterLt record {}? (default ()) - If set, return records where the specifiied field is less than the supplied value. Valid fields are behavior.

filterLteq record {}? (default ()) - If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are behavior.

recursive string? (default ()) - Show behaviors above this path?

behavior string? (default ()) - DEPRECATED: If set only shows folder behaviors matching this behavior type. Use filter[behavior] instead.

Return Type

BehaviorEntity[]|error - A list of Behaviors objects.

getBundlesId

Isolated FunctionRemote Function

function getBundlesId(int id) returns BundleEntity|error

Show Bundle

Parameters

id int - Bundle ID.

Return Type

BundleEntity|error - The Bundles object.

deleteBundlesId

Isolated FunctionRemote Function

function deleteBundlesId(int id) returns Response|error

Delete Bundle

Parameters

id int - Bundle ID.

Return Type

Response|error - No body.

patchBundlesId

Isolated FunctionRemote Function

function patchBundlesId(int id, BundlesIdBody payload) returns BundleEntity|error

Update Bundle

Parameters

id int - Bundle ID.

payload BundlesIdBody -

Return Type

BundleEntity|error - The Bundles object.

getBundles

Isolated FunctionRemote Function

function getBundles(int? userId, string? cursor, int? perPage, record {}? sortBy, record {}? filter, record {}? filterGt, record {}? filterGteq, record {}? filterLike, record {}? filterLt, record {}? filterLteq) returns BundleEntity[]|error

List Bundles

Parameters

userId int? (default ()) - User ID. Provide a value of 0 to operate the current session's user.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

sortBy record {}? (default ()) - If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are created_at and code.

filter record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are created_at.

filterGt record {}? (default ()) - If set, return records where the specifiied field is greater than the supplied value. Valid fields are created_at.

filterGteq record {}? (default ()) - If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are created_at.

filterLike record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are created_at.

filterLt record {}? (default ()) - If set, return records where the specifiied field is less than the supplied value. Valid fields are created_at.

filterLteq record {}? (default ()) - If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are created_at.

Return Type

BundleEntity[]|error - A list of Bundles objects.

postBundles

Isolated FunctionRemote Function

function postBundles(BundlesBody payload) returns BundleEntity|error

Create Bundle

Parameters

payload BundlesBody -

Return Type

BundleEntity|error - The Bundles object.

postBundlesIdShare

Isolated FunctionRemote Function

function postBundlesIdShare(int id, IdShareBody payload) returns Response|error

Send email(s) with a link to bundle

Parameters

id int - Bundle ID.

payload IdShareBody -

Return Type

Response|error - No body.

getBundleDownloads

Isolated FunctionRemote Function

function getBundleDownloads(string? cursor, int? perPage, record {}? sortBy, record {}? filter, record {}? filterGt, record {}? filterGteq, record {}? filterLike, record {}? filterLt, record {}? filterLteq, int? bundleId, int? bundleRegistrationId) returns BundleDownloadEntity[]|error

List Bundle Downloads

Parameters

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

sortBy record {}? (default ()) - If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are created_at.

filter record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are created_at.

filterGt record {}? (default ()) - If set, return records where the specifiied field is greater than the supplied value. Valid fields are created_at.

filterGteq record {}? (default ()) - If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are created_at.

filterLike record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are created_at.

filterLt record {}? (default ()) - If set, return records where the specifiied field is less than the supplied value. Valid fields are created_at.

filterLteq record {}? (default ()) - If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are created_at.

bundleId int? (default ()) - Bundle ID

bundleRegistrationId int? (default ()) - BundleRegistration ID

Return Type

BundleDownloadEntity[]|error - A list of BundleDownloads objects.

getBundleRecipients

Isolated FunctionRemote Function

function getBundleRecipients(int bundleId, int? userId, string? cursor, int? perPage, record {}? sortBy, record {}? filter, record {}? filterGt, record {}? filterGteq, record {}? filterLike, record {}? filterLt, record {}? filterLteq) returns BundleRecipientEntity[]|error

List Bundle Recipients

Parameters

bundleId int - List recipients for the bundle with this ID.

userId int? (default ()) - User ID. Provide a value of 0 to operate the current session's user.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

sortBy record {}? (default ()) - If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are has_registrations.

filter record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are has_registrations.

filterGt record {}? (default ()) - If set, return records where the specifiied field is greater than the supplied value. Valid fields are has_registrations.

filterGteq record {}? (default ()) - If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are has_registrations.

filterLike record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are has_registrations.

filterLt record {}? (default ()) - If set, return records where the specifiied field is less than the supplied value. Valid fields are has_registrations.

filterLteq record {}? (default ()) - If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are has_registrations.

Return Type

BundleRecipientEntity[]|error - A list of BundleRecipients objects.

postBundleRecipients

Isolated FunctionRemote Function

function postBundleRecipients(BundleRecipientsBody payload) returns BundleRecipientEntity|error

Create Bundle Recipient

Parameters

payload BundleRecipientsBody -

Return Type

BundleRecipientEntity|error - The BundleRecipients object.

getBundleRegistrations

Isolated FunctionRemote Function

function getBundleRegistrations(int? userId, string? cursor, int? perPage, int? bundleId) returns BundleRegistrationEntity[]|error

List Bundle Registrations

Parameters

userId int? (default ()) - User ID. Provide a value of 0 to operate the current session's user.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

bundleId int? (default ()) - ID of the associated Bundle

Return Type

BundleRegistrationEntity[]|error - A list of BundleRegistrations objects.

getClickwraps

Isolated FunctionRemote Function

function getClickwraps(string? cursor, int? perPage) returns ClickwrapEntity[]|error

List Clickwraps

Parameters

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

Return Type

ClickwrapEntity[]|error - A list of Clickwraps objects.

postClickwraps

Isolated FunctionRemote Function

function postClickwraps(ClickwrapsBody payload) returns ClickwrapEntity|error

Create Clickwrap

Parameters

payload ClickwrapsBody -

Return Type

ClickwrapEntity|error - The Clickwraps object.

getClickwrapsId

Isolated FunctionRemote Function

function getClickwrapsId(int id) returns ClickwrapEntity|error

Show Clickwrap

Parameters

id int - Clickwrap ID.

Return Type

ClickwrapEntity|error - The Clickwraps object.

deleteClickwrapsId

Isolated FunctionRemote Function

function deleteClickwrapsId(int id) returns Response|error

Delete Clickwrap

Parameters

id int - Clickwrap ID.

Return Type

Response|error - No body.

patchClickwrapsId

Isolated FunctionRemote Function

function patchClickwrapsId(int id, ClickwrapsIdBody payload) returns ClickwrapEntity|error

Update Clickwrap

Parameters

id int - Clickwrap ID.

payload ClickwrapsIdBody -

Return Type

ClickwrapEntity|error - The Clickwraps object.

getDnsRecords

Isolated FunctionRemote Function

function getDnsRecords(string? cursor, int? perPage) returns DnsRecordEntity[]|error

Show site DNS configuration.

Parameters

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

Return Type

DnsRecordEntity[]|error - A list of DnsRecords objects.

getExternalEvents

Isolated FunctionRemote Function

function getExternalEvents(string? cursor, int? perPage, record {}? sortBy, record {}? filter, record {}? filterGt, record {}? filterGteq, record {}? filterLike, record {}? filterLt, record {}? filterLteq) returns ExternalEventEntity[]|error

List External Events

Parameters

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

sortBy record {}? (default ()) - If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are remote_server_type, event_type, created_at, status, site_id or folder_behavior_id.

filter record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are created_at, event_type, remote_server_type, status or folder_behavior_id.

filterGt record {}? (default ()) - If set, return records where the specifiied field is greater than the supplied value. Valid fields are created_at, event_type, remote_server_type, status or folder_behavior_id.

filterGteq record {}? (default ()) - If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are created_at, event_type, remote_server_type, status or folder_behavior_id.

filterLike record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are created_at, event_type, remote_server_type, status or folder_behavior_id.

filterLt record {}? (default ()) - If set, return records where the specifiied field is less than the supplied value. Valid fields are created_at, event_type, remote_server_type, status or folder_behavior_id.

filterLteq record {}? (default ()) - If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are created_at, event_type, remote_server_type, status or folder_behavior_id.

Return Type

ExternalEventEntity[]|error - A list of ExternalEvents objects.

postExternalEvents

Isolated FunctionRemote Function

function postExternalEvents(ExternalEventsBody payload) returns ExternalEventEntity|error

Create External Event

Parameters

payload ExternalEventsBody -

Return Type

ExternalEventEntity|error - The ExternalEvents object.

getExternalEventsId

Isolated FunctionRemote Function

function getExternalEventsId(int id) returns ExternalEventEntity|error

Show External Event

Parameters

id int - External Event ID.

Return Type

ExternalEventEntity|error - The ExternalEvents object.

fileDownload

Isolated FunctionRemote Function

function fileDownload(string filePath, string? action, string? previewSize, boolean? withPreviews, boolean? withPriorityColor) returns FileEntity|error

Download file

Parameters

filePath string - Path to operate on.

action string? (default ()) - Can be blank, redirect or stat. If set to stat, we will return file information but without a download URL, and without logging a download. If set to redirect we will serve a 302 redirect directly to the file. This is used for integrations with Zapier, and is not recommended for most integrations.

previewSize string? (default ()) - Request a preview size. Can be small (default), large, xlarge, or pdf.

withPreviews boolean? (default ()) - Include file preview information?

withPriorityColor boolean? (default ()) - Include file priority color information?

Return Type

FileEntity|error - The Files object.

postFilesPath

Isolated FunctionRemote Function

function postFilesPath(string filePath, FilesFilepathBody payload) returns FileEntity|error

Upload file

Parameters

filePath string - Path to operate on.

payload FilesFilepathBody -

Return Type

FileEntity|error - The Files object.

deleteFilesPath

Isolated FunctionRemote Function

function deleteFilesPath(string filePath, boolean? recursive) returns Response|error

Delete file/folder

Parameters

filePath string - Path to operate on.

recursive boolean? (default ()) - If true, will recursively delete folers. Otherwise, will error on non-empty folders.

Return Type

Response|error - No body.

patchFilesPath

Isolated FunctionRemote Function

function patchFilesPath(string filePath, FilesFilepathBody3 payload) returns FileEntity|error

Update file/folder metadata

Parameters

filePath string - Path to operate on.

payload FilesFilepathBody3 -

Return Type

FileEntity|error - The Files object.

fileActionMetadata

Isolated FunctionRemote Function

function fileActionMetadata(string filePath, string? previewSize, boolean? withPreviews, boolean? withPriorityColor) returns FileEntity|error

Return metadata for file/folder

Parameters

filePath string - Path to operate on.

previewSize string? (default ()) - Request a preview size. Can be small (default), large, xlarge, or pdf.

withPreviews boolean? (default ()) - Include file preview information?

withPriorityColor boolean? (default ()) - Include file priority color information?

Return Type

FileEntity|error - The FileActions object.

fileActionCopy

Isolated FunctionRemote Function

function fileActionCopy(string filePath, CopyFilepathBody payload) returns FileActionEntity|error

Copy file/folder

Parameters

filePath string - Path to operate on.

payload CopyFilepathBody -

Return Type

FileActionEntity|error - The FileActions object.

fileActionMove

Isolated FunctionRemote Function

function fileActionMove(string filePath, MoveFilepathBody payload) returns FileActionEntity|error

Move file/folder

Parameters

filePath string - Path to operate on.

payload MoveFilepathBody -

Return Type

FileActionEntity|error - The FileActions object.

fileActionBeginUpload

Isolated FunctionRemote Function

function fileActionBeginUpload(string filePath, BeginUploadFilepathBody payload) returns FileUploadPartEntity[]|error

Begin file upload

Parameters

filePath string - Path to operate on.

payload BeginUploadFilepathBody -

Return Type

FileUploadPartEntity[]|error - The FileActions object.

deleteFileCommentsId

Isolated FunctionRemote Function

function deleteFileCommentsId(int id) returns Response|error

Delete File Comment

Parameters

id int - File Comment ID.

Return Type

Response|error - No body.

patchFileCommentsId

Isolated FunctionRemote Function

function patchFileCommentsId(int id, FileCommentsIdBody payload) returns FileCommentEntity|error

Update File Comment

Parameters

id int - File Comment ID.

payload FileCommentsIdBody -

Return Type

FileCommentEntity|error - The FileComments object.

postFileComments

Isolated FunctionRemote Function

function postFileComments(FileCommentsBody payload) returns FileCommentEntity|error

Create File Comment

Parameters

payload FileCommentsBody -

Return Type

FileCommentEntity|error - The FileComments object.

fileCommentListForPath

Isolated FunctionRemote Function

function fileCommentListForPath(string filePath, string? cursor, int? perPage) returns FileCommentEntity[]|error

List File Comments by path

Parameters

filePath string - Path to operate on.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

Return Type

FileCommentEntity[]|error - A list of FileComments objects.

deleteFileCommentReactionsId

Isolated FunctionRemote Function

function deleteFileCommentReactionsId(int id) returns Response|error

Delete File Comment Reaction

Parameters

id int - File Comment Reaction ID.

Return Type

Response|error - No body.

postFileCommentReactions

Isolated FunctionRemote Function

function postFileCommentReactions(FileCommentReactionsBody payload) returns FileCommentReactionEntity|error

Create File Comment Reaction

Parameters

payload FileCommentReactionsBody -

Return Type

FileCommentReactionEntity|error - The FileCommentReactions object.

getFileMigrationsId

Isolated FunctionRemote Function

function getFileMigrationsId(int id) returns FileMigrationEntity|error

Show File Migration

Parameters

id int - File Migration ID.

Return Type

FileMigrationEntity|error - The FileMigrations object.

folderListForPath

Isolated FunctionRemote Function

function folderListForPath(string folderPath, string? cursor, int? perPage, string? filter, string? previewSize, string? search, boolean? searchAll, boolean? withPreviews, boolean? withPriorityColor) returns FileEntity[]|error

List Folders by path

Parameters

folderPath string - Path to operate on.

cursor string? (default ()) - Send cursor to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

filter string? (default ()) - If specified, will filter folders/files list by this string. Wildcards of * and ? are acceptable here.

previewSize string? (default ()) - Request a preview size. Can be small (default), large, xlarge, or pdf.

search string? (default ()) - If search_all is true, provide the search string here. Otherwise, this parameter acts like an alias of filter.

searchAll boolean? (default ()) - Search entire site?

withPreviews boolean? (default ()) - Include file previews?

withPriorityColor boolean? (default ()) - Include file priority color information?

Return Type

FileEntity[]|error - A list of Folders objects.

postFoldersPath

Isolated FunctionRemote Function

function postFoldersPath(string folderPath) returns FileEntity|error

Create folder

Parameters

folderPath string - Path to operate on.

Return Type

FileEntity|error - The Folders object.

getFormFieldSets

Isolated FunctionRemote Function

function getFormFieldSets(int? userId, string? cursor, int? perPage) returns FormFieldSetEntity[]|error

List Form Field Sets

Parameters

userId int? (default ()) - User ID. Provide a value of 0 to operate the current session's user.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

Return Type

FormFieldSetEntity[]|error - A list of FormFieldSets objects.

postFormFieldSets

Isolated FunctionRemote Function

function postFormFieldSets(PostFormFieldSets payload) returns FormFieldSetEntity|error

Create Form Field Set

Parameters

payload PostFormFieldSets -

Return Type

FormFieldSetEntity|error - The FormFieldSets object.

getFormFieldSetsId

Isolated FunctionRemote Function

function getFormFieldSetsId(int id) returns FormFieldSetEntity|error

Show Form Field Set

Parameters

id int - Form Field Set ID.

Return Type

FormFieldSetEntity|error - The FormFieldSets object.

deleteFormFieldSetsId

Isolated FunctionRemote Function

function deleteFormFieldSetsId(int id) returns Response|error

Delete Form Field Set

Parameters

id int - Form Field Set ID.

Return Type

Response|error - No body.

patchFormFieldSetsId

Isolated FunctionRemote Function

function patchFormFieldSetsId(int id, PatchFormFieldSets payload) returns FormFieldSetEntity|error

Update Form Field Set

Parameters

id int - Form Field Set ID.

payload PatchFormFieldSets -

Return Type

FormFieldSetEntity|error - The FormFieldSets object.

getGroupsGroupIdUsers

Isolated FunctionRemote Function

function getGroupsGroupIdUsers(int groupId, int? userId, string? cursor, int? perPage) returns GroupUserEntity[]|error

List Group Users

Parameters

groupId int - Group ID. If provided, will return group_users of this group.

userId int? (default ()) - User ID. If provided, will return group_users of this user.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

Return Type

GroupUserEntity[]|error - A list of GroupUsers objects.

postGroupsGroupIdUsers

Isolated FunctionRemote Function

function postGroupsGroupIdUsers(int groupId, GroupIdUsersBody payload) returns UserEntity|error

Create User

Parameters

groupId int - Group ID to associate this user with.

payload GroupIdUsersBody -

Return Type

UserEntity|error - The Users object.

getGroupsGroupIdPermissions

Isolated FunctionRemote Function

function getGroupsGroupIdPermissions(string groupId, string? cursor, int? perPage, record {}? sortBy, record {}? filter, record {}? filterGt, record {}? filterGteq, record {}? filterLike, record {}? filterLt, record {}? filterLteq, string? userId, boolean? includeGroups) returns PermissionEntity[]|error

List Permissions

Parameters

groupId string - DEPRECATED: Group ID. If provided, will scope permissions to this group. Use filter[group_id] instead.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

sortBy record {}? (default ()) - If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are group_id, path, user_id or permission.

filter record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are group_id, user_id or path.

filterGt record {}? (default ()) - If set, return records where the specifiied field is greater than the supplied value. Valid fields are group_id, user_id or path.

filterGteq record {}? (default ()) - If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are group_id, user_id or path.

filterLike record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are group_id, user_id or path.

filterLt record {}? (default ()) - If set, return records where the specifiied field is less than the supplied value. Valid fields are group_id, user_id or path.

filterLteq record {}? (default ()) - If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are group_id, user_id or path.

userId string? (default ()) - DEPRECATED: User ID. If provided, will scope permissions to this user. Use filter[user_id] instead.

includeGroups boolean? (default ()) - If searching by user or group, also include user's permissions that are inherited from its groups?

Return Type

PermissionEntity[]|error - A list of Permissions objects.

deleteGroupsGroupIdMembershipsUserId

Isolated FunctionRemote Function

function deleteGroupsGroupIdMembershipsUserId(int groupId, int userId) returns Response|error

Delete Group User

Parameters

groupId int - Group ID from which to remove user.

userId int - User ID to remove from group.

Return Type

Response|error - No body.

patchGroupsGroupIdMembershipsUserId

Isolated FunctionRemote Function

function patchGroupsGroupIdMembershipsUserId(int groupId, int userId, MembershipsUserIdBody payload) returns GroupUserEntity|error

Update Group User

Parameters

groupId int - Group ID to add user to.

userId int - User ID to add to group.

payload MembershipsUserIdBody -

Return Type

GroupUserEntity|error - The GroupUsers object.

getGroupsId

Isolated FunctionRemote Function

function getGroupsId(int id) returns GroupEntity|error

Show Group

Parameters

id int - Group ID.

Return Type

GroupEntity|error - The Groups object.

deleteGroupsId

Isolated FunctionRemote Function

function deleteGroupsId(int id) returns Response|error

Delete Group

Parameters

id int - Group ID.

Return Type

Response|error - No body.

patchGroupsId

Isolated FunctionRemote Function

function patchGroupsId(int id, GroupsIdBody payload) returns GroupEntity|error

Update Group

Parameters

id int - Group ID.

payload GroupsIdBody -

Return Type

GroupEntity|error - The Groups object.

getGroups

Isolated FunctionRemote Function

function getGroups(string? cursor, int? perPage, record {}? sortBy, record {}? filter, record {}? filterGt, record {}? filterGteq, record {}? filterLike, record {}? filterLt, record {}? filterLteq, string? ids) returns GroupEntity[]|error

List Groups

Parameters

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

sortBy record {}? (default ()) - If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are name.

filter record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are name.

filterGt record {}? (default ()) - If set, return records where the specifiied field is greater than the supplied value. Valid fields are name.

filterGteq record {}? (default ()) - If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are name.

filterLike record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are name.

filterLt record {}? (default ()) - If set, return records where the specifiied field is less than the supplied value. Valid fields are name.

filterLteq record {}? (default ()) - If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are name.

ids string? (default ()) - Comma-separated list of group ids to include in results.

Return Type

GroupEntity[]|error - A list of Groups objects.

postGroups

Isolated FunctionRemote Function

function postGroups(GroupsBody payload) returns GroupEntity|error

Create Group

Parameters

payload GroupsBody -

Return Type

GroupEntity|error - The Groups object.

deleteGroupUsersId

Isolated FunctionRemote Function

function deleteGroupUsersId(int id, int groupId, int userId) returns Response|error

Delete Group User

Parameters

id int - Group User ID.

groupId int - Group ID from which to remove user.

userId int - User ID to remove from group.

Return Type

Response|error - No body.

patchGroupUsersId

Isolated FunctionRemote Function

function patchGroupUsersId(int id, GroupUsersIdBody payload) returns GroupUserEntity|error

Update Group User

Parameters

id int - Group User ID.

payload GroupUsersIdBody -

Return Type

GroupUserEntity|error - The GroupUsers object.

getGroupUsers

Isolated FunctionRemote Function

function getGroupUsers(int? userId, string? cursor, int? perPage, int? groupId) returns GroupUserEntity[]|error

List Group Users

Parameters

userId int? (default ()) - User ID. If provided, will return group_users of this user.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

groupId int? (default ()) - Group ID. If provided, will return group_users of this group.

Return Type

GroupUserEntity[]|error - A list of GroupUsers objects.

postGroupUsers

Isolated FunctionRemote Function

function postGroupUsers(GroupUsersBody payload) returns GroupUserEntity|error

Create Group User

Parameters

payload GroupUsersBody -

Return Type

GroupUserEntity|error - The GroupUsers object.

historyListForFile

Isolated FunctionRemote Function

function historyListForFile(string filePath, string? startAt, string? endAt, string? display, string? cursor, int? perPage, record {}? sortBy) returns ActionEntity[]|error

List history for specific file.

Parameters

filePath string - Path to operate on.

startAt string? (default ()) - Leave blank or set to a date/time to filter earlier entries.

endAt string? (default ()) - Leave blank or set to a date/time to filter later entries.

display string? (default ()) - Display format. Leave blank or set to full or parent.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

sortBy record {}? (default ()) - If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are user_id and created_at.

Return Type

ActionEntity[]|error - A list of History objects.

historyListForFolder

Isolated FunctionRemote Function

function historyListForFolder(string folderPath, string? startAt, string? endAt, string? display, string? cursor, int? perPage, record {}? sortBy) returns ActionEntity[]|error

List history for specific folder.

Parameters

folderPath string - Path to operate on.

startAt string? (default ()) - Leave blank or set to a date/time to filter earlier entries.

endAt string? (default ()) - Leave blank or set to a date/time to filter later entries.

display string? (default ()) - Display format. Leave blank or set to full or parent.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

sortBy record {}? (default ()) - If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are user_id and created_at.

Return Type

ActionEntity[]|error - A list of History objects.

historyListForUser

Isolated FunctionRemote Function

function historyListForUser(int userId, string? startAt, string? endAt, string? display, string? cursor, int? perPage, record {}? sortBy) returns ActionEntity[]|error

List history for specific user.

Parameters

userId int - User ID.

startAt string? (default ()) - Leave blank or set to a date/time to filter earlier entries.

endAt string? (default ()) - Leave blank or set to a date/time to filter later entries.

display string? (default ()) - Display format. Leave blank or set to full or parent.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

sortBy record {}? (default ()) - If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are user_id and created_at.

Return Type

ActionEntity[]|error - A list of History objects.

historyListLogins

Isolated FunctionRemote Function

function historyListLogins(string? startAt, string? endAt, string? display, string? cursor, int? perPage, record {}? sortBy) returns ActionEntity[]|error

List site login history.

Parameters

startAt string? (default ()) - Leave blank or set to a date/time to filter earlier entries.

endAt string? (default ()) - Leave blank or set to a date/time to filter later entries.

display string? (default ()) - Display format. Leave blank or set to full or parent.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

sortBy record {}? (default ()) - If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are user_id and created_at.

Return Type

ActionEntity[]|error - A list of History objects.

historyList

Isolated FunctionRemote Function

function historyList(string? startAt, string? endAt, string? display, string? cursor, int? perPage, record {}? sortBy, record {}? filter, record {}? filterGt, record {}? filterGteq, record {}? filterLike, record {}? filterLt, record {}? filterLteq) returns ActionEntity[]|error

List site full action history.

Parameters

startAt string? (default ()) - Leave blank or set to a date/time to filter earlier entries.

endAt string? (default ()) - Leave blank or set to a date/time to filter later entries.

display string? (default ()) - Display format. Leave blank or set to full or parent.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

sortBy record {}? (default ()) - If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are path, folder, user_id or created_at.

filter record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are user_id, folder or path.

filterGt record {}? (default ()) - If set, return records where the specifiied field is greater than the supplied value. Valid fields are user_id, folder or path.

filterGteq record {}? (default ()) - If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are user_id, folder or path.

filterLike record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are user_id, folder or path.

filterLt record {}? (default ()) - If set, return records where the specifiied field is less than the supplied value. Valid fields are user_id, folder or path.

filterLteq record {}? (default ()) - If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are user_id, folder or path.

Return Type

ActionEntity[]|error - A list of History objects.

postHistoryExports

Isolated FunctionRemote Function

function postHistoryExports(HistoryExportsBody payload) returns HistoryExportEntity|error

Create History Export

Parameters

payload HistoryExportsBody -

Return Type

HistoryExportEntity|error - The HistoryExports object.

getHistoryExportsId

Isolated FunctionRemote Function

function getHistoryExportsId(int id) returns HistoryExportEntity|error

Show History Export

Parameters

id int - History Export ID.

Return Type

HistoryExportEntity|error - The HistoryExports object.

getHistoryExportResults

Isolated FunctionRemote Function

function getHistoryExportResults(int historyExportId, int? userId, string? cursor, int? perPage) returns HistoryExportResultEntity[]|error

List History Export Results

Parameters

historyExportId int - ID of the associated history export.

userId int? (default ()) - User ID. Provide a value of 0 to operate the current session's user.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

Return Type

HistoryExportResultEntity[]|error - A list of HistoryExportResults objects.

getInboxRecipients

Isolated FunctionRemote Function

function getInboxRecipients(int inboxId, int? userId, string? cursor, int? perPage, record {}? sortBy, record {}? filter, record {}? filterGt, record {}? filterGteq, record {}? filterLike, record {}? filterLt, record {}? filterLteq) returns InboxRecipientEntity[]|error

List Inbox Recipients

Parameters

inboxId int - List recipients for the inbox with this ID.

userId int? (default ()) - User ID. Provide a value of 0 to operate the current session's user.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

sortBy record {}? (default ()) - If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are has_registrations.

filter record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are has_registrations.

filterGt record {}? (default ()) - If set, return records where the specifiied field is greater than the supplied value. Valid fields are has_registrations.

filterGteq record {}? (default ()) - If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are has_registrations.

filterLike record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are has_registrations.

filterLt record {}? (default ()) - If set, return records where the specifiied field is less than the supplied value. Valid fields are has_registrations.

filterLteq record {}? (default ()) - If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are has_registrations.

Return Type

InboxRecipientEntity[]|error - A list of InboxRecipients objects.

postInboxRecipients

Isolated FunctionRemote Function

function postInboxRecipients(InboxRecipientsBody payload) returns InboxRecipientEntity|error

Create Inbox Recipient

Parameters

payload InboxRecipientsBody -

Return Type

InboxRecipientEntity|error - The InboxRecipients object.

getInboxRegistrations

Isolated FunctionRemote Function

function getInboxRegistrations(int folderBehaviorId, string? cursor, int? perPage) returns InboxRegistrationEntity[]|error

List Inbox Registrations

Parameters

folderBehaviorId int - ID of the associated Inbox.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

Return Type

InboxRegistrationEntity[]|error - A list of InboxRegistrations objects.

getInboxUploads

Isolated FunctionRemote Function

function getInboxUploads(string? cursor, int? perPage, record {}? sortBy, record {}? filter, record {}? filterGt, record {}? filterGteq, record {}? filterLike, record {}? filterLt, record {}? filterLteq, int? inboxRegistrationId, int? inboxId) returns InboxUploadEntity[]|error

List Inbox Uploads

Parameters

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

sortBy record {}? (default ()) - If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are created_at.

filter record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are created_at.

filterGt record {}? (default ()) - If set, return records where the specifiied field is greater than the supplied value. Valid fields are created_at.

filterGteq record {}? (default ()) - If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are created_at.

filterLike record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are created_at.

filterLt record {}? (default ()) - If set, return records where the specifiied field is less than the supplied value. Valid fields are created_at.

filterLteq record {}? (default ()) - If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are created_at.

inboxRegistrationId int? (default ()) - InboxRegistration ID

inboxId int? (default ()) - Inbox ID

Return Type

InboxUploadEntity[]|error - A list of InboxUploads objects.

getInvoicesId

Isolated FunctionRemote Function

function getInvoicesId(int id) returns AccountLineItemEntity|error

Show Invoice

Parameters

id int - Invoice ID.

Return Type

AccountLineItemEntity|error - The Invoices object.

getInvoices

Isolated FunctionRemote Function

function getInvoices(string? cursor, int? perPage) returns AccountLineItemEntity[]|error

List Invoices

Parameters

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

Return Type

AccountLineItemEntity[]|error - A list of Invoices objects.

getIpAddressesReserved

Isolated FunctionRemote Function

function getIpAddressesReserved(string? cursor, int? perPage) returns PublicIpAddressEntity[]|error

List all possible public IP addresses

Parameters

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

Return Type

PublicIpAddressEntity[]|error - A list of IpAddresses objects.

getIpAddresses

Isolated FunctionRemote Function

function getIpAddresses(string? cursor, int? perPage) returns IpAddressEntity[]|error

List IP Addresses associated with the current site

Parameters

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

Return Type

IpAddressEntity[]|error - A list of IpAddresses objects.

lockListForPath

Isolated FunctionRemote Function

function lockListForPath(string lockPath, string? cursor, int? perPage, boolean? includeChildren) returns LockEntity[]|error

List Locks by path

Parameters

lockPath string - Path to operate on.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

includeChildren boolean? (default ()) - Include locks from children objects?

Return Type

LockEntity[]|error - A list of Locks objects.

postLocksPath

Isolated FunctionRemote Function

function postLocksPath(string lockPath, LocksLockpathBody payload) returns LockEntity|error

Create Lock

Parameters

lockPath string - Path

payload LocksLockpathBody -

Return Type

LockEntity|error - The Locks object.

deleteLocksPath

Isolated FunctionRemote Function

function deleteLocksPath(string lockPath, string token) returns Response|error

Delete Lock

Parameters

lockPath string - Path

token string - Lock token

Return Type

Response|error - No body.

getMessagesId

Isolated FunctionRemote Function

function getMessagesId(int id) returns MessageEntity|error

Show Message

Parameters

id int - Message ID.

Return Type

MessageEntity|error - The Messages object.

deleteMessagesId

Isolated FunctionRemote Function

function deleteMessagesId(int id) returns Response|error

Delete Message

Parameters

id int - Message ID.

Return Type

Response|error - No body.

patchMessagesId

Isolated FunctionRemote Function

function patchMessagesId(int id, MessagesIdBody payload) returns MessageEntity|error

Update Message

Parameters

id int - Message ID.

payload MessagesIdBody -

Return Type

MessageEntity|error - The Messages object.

getMessages

Isolated FunctionRemote Function

function getMessages(int projectId, int? userId, string? cursor, int? perPage) returns MessageEntity[]|error

List Messages

Parameters

projectId int - Project for which to return messages.

userId int? (default ()) - User ID. Provide a value of 0 to operate the current session's user.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

Return Type

MessageEntity[]|error - A list of Messages objects.

postMessages

Isolated FunctionRemote Function

function postMessages(MessagesBody payload) returns MessageEntity|error

Create Message

Parameters

payload MessagesBody -

Return Type

MessageEntity|error - The Messages object.

getMessageCommentsId

Isolated FunctionRemote Function

function getMessageCommentsId(int id) returns MessageCommentEntity|error

Show Message Comment

Parameters

id int - Message Comment ID.

Return Type

MessageCommentEntity|error - The MessageComments object.

deleteMessageCommentsId

Isolated FunctionRemote Function

function deleteMessageCommentsId(int id) returns Response|error

Delete Message Comment

Parameters

id int - Message Comment ID.

Return Type

Response|error - No body.

patchMessageCommentsId

Isolated FunctionRemote Function

function patchMessageCommentsId(int id, MessageCommentsIdBody payload) returns MessageCommentEntity|error

Update Message Comment

Parameters

id int - Message Comment ID.

payload MessageCommentsIdBody -

Return Type

MessageCommentEntity|error - The MessageComments object.

getMessageComments

Isolated FunctionRemote Function

function getMessageComments(int messageId, int? userId, string? cursor, int? perPage) returns MessageCommentEntity[]|error

List Message Comments

Parameters

messageId int - Message comment to return comments for.

userId int? (default ()) - User ID. Provide a value of 0 to operate the current session's user.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

Return Type

MessageCommentEntity[]|error - A list of MessageComments objects.

postMessageComments

Isolated FunctionRemote Function

function postMessageComments(MessageCommentsBody payload) returns MessageCommentEntity|error

Create Message Comment

Parameters

payload MessageCommentsBody -

Return Type

MessageCommentEntity|error - The MessageComments object.

getMessageCommentReactionsId

Isolated FunctionRemote Function

function getMessageCommentReactionsId(int id) returns MessageCommentReactionEntity|error

Show Message Comment Reaction

Parameters

id int - Message Comment Reaction ID.

Return Type

MessageCommentReactionEntity|error - The MessageCommentReactions object.

deleteMessageCommentReactionsId

Isolated FunctionRemote Function

function deleteMessageCommentReactionsId(int id) returns Response|error

Delete Message Comment Reaction

Parameters

id int - Message Comment Reaction ID.

Return Type

Response|error - No body.

getMessageCommentReactions

Isolated FunctionRemote Function

function getMessageCommentReactions(int messageCommentId, int? userId, string? cursor, int? perPage) returns MessageCommentReactionEntity[]|error

List Message Comment Reactions

Parameters

messageCommentId int - Message comment to return reactions for.

userId int? (default ()) - User ID. Provide a value of 0 to operate the current session's user.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

Return Type

MessageCommentReactionEntity[]|error - A list of MessageCommentReactions objects.

postMessageCommentReactions

Isolated FunctionRemote Function

function postMessageCommentReactions(MessageCommentReactionsBody payload) returns MessageCommentReactionEntity|error

Create Message Comment Reaction

Parameters

payload MessageCommentReactionsBody -

Return Type

MessageCommentReactionEntity|error - The MessageCommentReactions object.

getMessageReactionsId

Isolated FunctionRemote Function

function getMessageReactionsId(int id) returns MessageReactionEntity|error

Show Message Reaction

Parameters

id int - Message Reaction ID.

Return Type

MessageReactionEntity|error - The MessageReactions object.

deleteMessageReactionsId

Isolated FunctionRemote Function

function deleteMessageReactionsId(int id) returns Response|error

Delete Message Reaction

Parameters

id int - Message Reaction ID.

Return Type

Response|error - No body.

getMessageReactions

Isolated FunctionRemote Function

function getMessageReactions(int messageId, int? userId, string? cursor, int? perPage) returns MessageReactionEntity[]|error

List Message Reactions

Parameters

messageId int - Message to return reactions for.

userId int? (default ()) - User ID. Provide a value of 0 to operate the current session's user.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

Return Type

MessageReactionEntity[]|error - A list of MessageReactions objects.

postMessageReactions

Isolated FunctionRemote Function

function postMessageReactions(MessageReactionsBody payload) returns MessageReactionEntity|error

Create Message Reaction

Parameters

payload MessageReactionsBody -

Return Type

MessageReactionEntity|error - The MessageReactions object.

getNotificationsId

Isolated FunctionRemote Function

function getNotificationsId(int id) returns NotificationEntity|error

Show Notification

Parameters

id int - Notification ID.

Return Type

NotificationEntity|error - The Notifications object.

deleteNotificationsId

Isolated FunctionRemote Function

function deleteNotificationsId(int id) returns Response|error

Delete Notification

Parameters

id int - Notification ID.

Return Type

Response|error - No body.

patchNotificationsId

Isolated FunctionRemote Function

function patchNotificationsId(int id, NotificationsIdBody payload) returns NotificationEntity|error

Update Notification

Parameters

id int - Notification ID.

payload NotificationsIdBody -

Return Type

NotificationEntity|error - The Notifications object.

getNotifications

Isolated FunctionRemote Function

function getNotifications(int? userId, string? cursor, int? perPage, record {}? sortBy, record {}? filter, record {}? filterGt, record {}? filterGteq, record {}? filterLike, record {}? filterLt, record {}? filterLteq, int? groupId, string? path, boolean? includeAncestors) returns NotificationEntity[]|error

List Notifications

Parameters

userId int? (default ()) - DEPRECATED: Show notifications for this User ID. Use filter[user_id] instead.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

sortBy record {}? (default ()) - If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are path, user_id or group_id.

filter record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are user_id, group_id or path.

filterGt record {}? (default ()) - If set, return records where the specifiied field is greater than the supplied value. Valid fields are user_id, group_id or path.

filterGteq record {}? (default ()) - If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are user_id, group_id or path.

filterLike record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are user_id, group_id or path.

filterLt record {}? (default ()) - If set, return records where the specifiied field is less than the supplied value. Valid fields are user_id, group_id or path.

filterLteq record {}? (default ()) - If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are user_id, group_id or path.

groupId int? (default ()) - DEPRECATED: Show notifications for this Group ID. Use filter[group_id] instead.

path string? (default ()) - Show notifications for this Path.

includeAncestors boolean? (default ()) - If include_ancestors is true and path is specified, include notifications for any parent paths. Ignored if path is not specified.

Return Type

NotificationEntity[]|error - A list of Notifications objects.

postNotifications

Isolated FunctionRemote Function

function postNotifications(NotificationsBody payload) returns NotificationEntity|error

Create Notification

Parameters

payload NotificationsBody -

Return Type

NotificationEntity|error - The Notifications object.

getPaymentsId

Isolated FunctionRemote Function

function getPaymentsId(int id) returns AccountLineItemEntity|error

Show Payment

Parameters

id int - Payment ID.

Return Type

AccountLineItemEntity|error - The Payments object.

getPayments

Isolated FunctionRemote Function

function getPayments(string? cursor, int? perPage) returns AccountLineItemEntity[]|error

List Payments

Parameters

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

Return Type

AccountLineItemEntity[]|error - A list of Payments objects.

deletePermissionsId

Isolated FunctionRemote Function

function deletePermissionsId(int id) returns Response|error

Delete Permission

Parameters

id int - Permission ID.

Return Type

Response|error - No body.

getPermissions

Isolated FunctionRemote Function

function getPermissions(string? cursor, int? perPage, record {}? sortBy, record {}? filter, record {}? filterGt, record {}? filterGteq, record {}? filterLike, record {}? filterLt, record {}? filterLteq, string? groupId, string? userId, boolean? includeGroups) returns PermissionEntity[]|error

List Permissions

Parameters

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

sortBy record {}? (default ()) - If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are group_id, path, user_id or permission.

filter record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are group_id, user_id or path.

filterGt record {}? (default ()) - If set, return records where the specifiied field is greater than the supplied value. Valid fields are group_id, user_id or path.

filterGteq record {}? (default ()) - If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are group_id, user_id or path.

filterLike record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are group_id, user_id or path.

filterLt record {}? (default ()) - If set, return records where the specifiied field is less than the supplied value. Valid fields are group_id, user_id or path.

filterLteq record {}? (default ()) - If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are group_id, user_id or path.

groupId string? (default ()) - DEPRECATED: Group ID. If provided, will scope permissions to this group. Use filter[group_id] instead.

userId string? (default ()) - DEPRECATED: User ID. If provided, will scope permissions to this user. Use filter[user_id] instead.

includeGroups boolean? (default ()) - If searching by user or group, also include user's permissions that are inherited from its groups?

Return Type

PermissionEntity[]|error - A list of Permissions objects.

postPermissions

Isolated FunctionRemote Function

function postPermissions(PermissionsBody payload) returns PermissionEntity|error

Create Permission

Parameters

payload PermissionsBody -

Return Type

PermissionEntity|error - The Permissions object.

getProjectsId

Isolated FunctionRemote Function

function getProjectsId(int id) returns ProjectEntity|error

Show Project

Parameters

id int - Project ID.

Return Type

ProjectEntity|error - The Projects object.

deleteProjectsId

Isolated FunctionRemote Function

function deleteProjectsId(int id) returns Response|error

Delete Project

Parameters

id int - Project ID.

Return Type

Response|error - No body.

patchProjectsId

Isolated FunctionRemote Function

function patchProjectsId(int id, ProjectsIdBody payload) returns ProjectEntity|error

Update Project

Parameters

id int - Project ID.

payload ProjectsIdBody -

Return Type

ProjectEntity|error - The Projects object.

getProjects

Isolated FunctionRemote Function

function getProjects(string? cursor, int? perPage) returns ProjectEntity[]|error

List Projects

Parameters

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

Return Type

ProjectEntity[]|error - A list of Projects objects.

postProjects

Isolated FunctionRemote Function

function postProjects(ProjectsBody payload) returns ProjectEntity|error

Create Project

Parameters

payload ProjectsBody -

Return Type

ProjectEntity|error - The Projects object.

getPublicKeysId

Isolated FunctionRemote Function

function getPublicKeysId(int id) returns PublicKeyEntity|error

Show Public Key

Parameters

id int - Public Key ID.

Return Type

PublicKeyEntity|error - The PublicKeys object.

deletePublicKeysId

Isolated FunctionRemote Function

function deletePublicKeysId(int id) returns Response|error

Delete Public Key

Parameters

id int - Public Key ID.

Return Type

Response|error - No body.

patchPublicKeysId

Isolated FunctionRemote Function

function patchPublicKeysId(int id, PublicKeysIdBody payload) returns PublicKeyEntity|error

Update Public Key

Parameters

id int - Public Key ID.

payload PublicKeysIdBody -

Return Type

PublicKeyEntity|error - The PublicKeys object.

getPublicKeys

Isolated FunctionRemote Function

function getPublicKeys(int? userId, string? cursor, int? perPage) returns PublicKeyEntity[]|error

List Public Keys

Parameters

userId int? (default ()) - User ID. Provide a value of 0 to operate the current session's user.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

Return Type

PublicKeyEntity[]|error - A list of PublicKeys objects.

postPublicKeys

Isolated FunctionRemote Function

function postPublicKeys(PublicKeysBody payload) returns PublicKeyEntity|error

Create Public Key

Parameters

payload PublicKeysBody -

Return Type

PublicKeyEntity|error - The PublicKeys object.

getRemoteServers

Isolated FunctionRemote Function

function getRemoteServers(string? cursor, int? perPage) returns RemoteServerEntity[]|error

List Remote Servers

Parameters

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

Return Type

RemoteServerEntity[]|error - A list of RemoteServers objects.

postRemoteServers

Isolated FunctionRemote Function

function postRemoteServers(RemoteServersBody payload) returns RemoteServerEntity|error

Create Remote Server

Parameters

payload RemoteServersBody -

Return Type

RemoteServerEntity|error - The RemoteServers object.

getRemoteServersId

Isolated FunctionRemote Function

function getRemoteServersId(int id) returns RemoteServerEntity|error

Show Remote Server

Parameters

id int - Remote Server ID.

Return Type

RemoteServerEntity|error - The RemoteServers object.

deleteRemoteServersId

Isolated FunctionRemote Function

function deleteRemoteServersId(int id) returns Response|error

Delete Remote Server

Parameters

id int - Remote Server ID.

Return Type

Response|error - No body.

patchRemoteServersId

Isolated FunctionRemote Function

function patchRemoteServersId(int id, RemoteServersIdBody payload) returns RemoteServerEntity|error

Update Remote Server

Parameters

id int - Remote Server ID.

payload RemoteServersIdBody -

Return Type

RemoteServerEntity|error - The RemoteServers object.

deleteRequestsId

Isolated FunctionRemote Function

function deleteRequestsId(int id) returns Response|error

Delete Request

Parameters

id int - Request ID.

Return Type

Response|error - No body.

getRequests

Isolated FunctionRemote Function

function getRequests(string? cursor, int? perPage, record {}? sortBy, boolean? mine, string? requestPath) returns RequestEntity[]|error

List Requests

Parameters

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

sortBy record {}? (default ()) - If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are destination.

mine boolean? (default ()) - Only show requests of the current user? (Defaults to true if current user is not a site admin.)

requestPath string? (default ()) - Path to show requests for. If omitted, shows all paths. Send / to represent the root directory.

Return Type

RequestEntity[]|error - A list of Requests objects.

postRequests

Isolated FunctionRemote Function

function postRequests(RequestsBody payload) returns RequestEntity|error

Create Request

Parameters

payload RequestsBody -

Return Type

RequestEntity|error - The Requests object.

getRequestsFoldersPath

Isolated FunctionRemote Function

function getRequestsFoldersPath(string folderPath, string? cursor, int? perPage, record {}? sortBy, boolean? mine) returns RequestEntity[]|error

List Requests

Parameters

folderPath string - Path to show requests for. If omitted, shows all paths. Send / to represent the root directory.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

sortBy record {}? (default ()) - If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are destination.

mine boolean? (default ()) - Only show requests of the current user? (Defaults to true if current user is not a site admin.)

Return Type

RequestEntity[]|error - A list of Requests objects.

postSessions

Isolated FunctionRemote Function

function postSessions(SessionsBody payload) returns SessionEntity|error

Create user session (log in)

Parameters

payload SessionsBody -

Return Type

SessionEntity|error - The Sessions object.

deleteSessions

Isolated FunctionRemote Function

function deleteSessions() returns Response|error

Delete user session (log out)

Return Type

Response|error - No body.

getSettingsChanges

Isolated FunctionRemote Function

function getSettingsChanges(string? cursor, int? perPage, record {}? sortBy, record {}? filter, record {}? filterGt, record {}? filterGteq, record {}? filterLike, record {}? filterLt, record {}? filterLteq) returns SettingsChangeEntity[]|error

List Settings Changes

Parameters

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

sortBy record {}? (default ()) - If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are api_key_id, created_at or user_id.

filter record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are api_key_id and user_id.

filterGt record {}? (default ()) - If set, return records where the specifiied field is greater than the supplied value. Valid fields are api_key_id and user_id.

filterGteq record {}? (default ()) - If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are api_key_id and user_id.

filterLike record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are api_key_id and user_id.

filterLt record {}? (default ()) - If set, return records where the specifiied field is less than the supplied value. Valid fields are api_key_id and user_id.

filterLteq record {}? (default ()) - If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are api_key_id and user_id.

Return Type

SettingsChangeEntity[]|error - A list of SettingsChanges objects.

getSsoStrategiesId

Isolated FunctionRemote Function

function getSsoStrategiesId(int id) returns SsoStrategyEntity|error

Show Sso Strategy

Parameters

id int - Sso Strategy ID.

Return Type

SsoStrategyEntity|error - The SsoStrategies object.

getSsoStrategies

Isolated FunctionRemote Function

function getSsoStrategies(string? cursor, int? perPage) returns SsoStrategyEntity[]|error

List Sso Strategies

Parameters

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

Return Type

SsoStrategyEntity[]|error - A list of SsoStrategies objects.

getStylesPath

Isolated FunctionRemote Function

function getStylesPath(string stylePath) returns StyleEntity|error

Show Style

Parameters

stylePath string - Style path.

Return Type

StyleEntity|error - The Styles object.

deleteStylesPath

Isolated FunctionRemote Function

function deleteStylesPath(string stylePath) returns Response|error

Delete Style

Parameters

stylePath string - Style path.

Return Type

Response|error - No body.

patchStylesPath

Isolated FunctionRemote Function

function patchStylesPath(string stylePath, StylesStylepathBody payload) returns StyleEntity|error

Update Style

Parameters

stylePath string - Style path.

payload StylesStylepathBody -

Return Type

StyleEntity|error - The Styles object.

getSyncJobs

Isolated FunctionRemote Function

function getSyncJobs(string? cursor, int? perPage) returns SyncJobEntity[]|error

List Sync Jobs

Parameters

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

Return Type

SyncJobEntity[]|error - A list of SyncJobs objects.

getUsageSnapshots

Isolated FunctionRemote Function

function getUsageSnapshots(string? cursor, int? perPage) returns UsageSnapshotEntity[]|error

List Usage Snapshots

Parameters

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

Return Type

UsageSnapshotEntity[]|error - A list of UsageSnapshots objects.

getUsageDailySnapshots

Isolated FunctionRemote Function

function getUsageDailySnapshots(string? cursor, int? perPage, record {}? sortBy, record {}? filter, record {}? filterGt, record {}? filterGteq, record {}? filterLike, record {}? filterLt, record {}? filterLteq) returns UsageDailySnapshotEntity[]|error

List Usage Daily Snapshots

Parameters

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

sortBy record {}? (default ()) - If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are date and usage_snapshot_id.

filter record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are date and usage_snapshot_id.

filterGt record {}? (default ()) - If set, return records where the specifiied field is greater than the supplied value. Valid fields are date and usage_snapshot_id.

filterGteq record {}? (default ()) - If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are date and usage_snapshot_id.

filterLike record {}? (default ()) - If set, return records where the specifiied field is equal to the supplied value. Valid fields are date and usage_snapshot_id.

filterLt record {}? (default ()) - If set, return records where the specifiied field is less than the supplied value. Valid fields are date and usage_snapshot_id.

filterLteq record {}? (default ()) - If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are date and usage_snapshot_id.

Return Type

UsageDailySnapshotEntity[]|error - A list of UsageDailySnapshots objects.

getUserCipherUses

Isolated FunctionRemote Function

function getUserCipherUses(int? userId, string? cursor, int? perPage) returns UserCipherUseEntity[]|error

List User Cipher Uses

Parameters

userId int? (default ()) - User ID. Provide a value of 0 to operate the current session's user.

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

Return Type

UserCipherUseEntity[]|error - A list of UserCipherUses objects.

getUserRequests

Isolated FunctionRemote Function

function getUserRequests(string? cursor, int? perPage) returns UserRequestEntity[]|error

List User Requests

Parameters

cursor string? (default ()) - Used for pagination. Send a cursor value to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header.

perPage int? (default ()) - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).

Return Type

UserRequestEntity[]|error - A list of UserRequests objects.

postUserRequests

Isolated FunctionRemote Function

function postUserRequests(UserRequestsBody payload) returns UserRequestEntity|error

Create User Request

Parameters

payload UserRequestsBody -

Return Type

UserRequestEntity|error - The UserRequests object.

getUserRequestsId

Isolated FunctionRemote Function

function getUserRequestsId(int id) returns UserRequestEntity|error

Show User Request

Parameters

id int - User Request ID.

Return Type

UserRequestEntity|error - The UserRequests object.

deleteUserRequestsId

Isolated FunctionRemote Function

function deleteUserRequestsId(int id) returns Response|error

Delete User Request

Parameters

id int - User Request ID.

Return Type

Response|error - No body.

postWebhookTests

Isolated FunctionRemote Function

function postWebhookTests(WebhookTestsBody payload) returns WebhookTestEntity|error

Create Webhook Test

Parameters

payload WebhookTestsBody -

Return Type

WebhookTestEntity|error - The WebhookTests object.

Records

files.com: AccountLineItemEntity

List Payments

Fields

id int? - Line item Id

amount decimal? - Line item amount

balance decimal? - Line item balance

created_at string? - Line item created at

currency string? - Line item currency

download_uri string? - Line item download uri

invoice_line_items InvoiceLineItemEntity? - Associated invoice line items

method string? - Line item payment method

payment_line_items PaymentLineItemEntity? - Associated payment line items

payment_reversed_at string? - Date/time payment was reversed if applicable

payment_type string? - Type of payment if applicable

site_name string? - Site name this line item is for

'type string? - Type of line item, either payment or invoice

updated_at string? - Line item updated at

files.com: ActionEntity

List site full action history.

Fields

id int? - Action ID

path string? - Path

when string? - Action occurrence date/time

destination string? - The destination path for this action, if applicable

display string? - Friendly displayed output

ip string? - IP Address that performed this action

'source string? - The source path for this action, if applicable

targets string[]? - Targets

user_id int? - User ID

username string? - Username

action string? - Type of action

failure_type string? - Failure type. If action was a user login or session failure, why did it fail?

interface string? - Interface on which this action occurred.

files.com: ActionNotificationExportEntity

Show Action Notification Export

Fields

id int? - History Export ID

export_version string? - Version of the underlying records for the export.

start_at string? - Start date/time of export range.

end_at string? - End date/time of export range.

status string? - Status of export. Valid values: building, ready, or failed

query_path string? - Return notifications that were triggered by actions on this specific path.

query_folder string? - Return notifications that were triggered by actions in this folder.

query_message string? - Error message associated with the request, if any.

query_request_method string? - The HTTP request method used by the webhook.

query_request_url string? - The target webhook URL.

query_status string? - The HTTP status returned from the server in response to the webhook request.

query_success boolean? - true if the webhook request succeeded (i.e. returned a 200 or 204 response status). false otherwise.

results_url string? - If status is ready, this will be a URL where all the results can be downloaded at once as a CSV.

files.com: ActionNotificationExportResultEntity

List Action Notification Export Results

Fields

id int? - Notification ID

created_at int? - When the notification was sent.

status int? - HTTP status code returned in the webhook response.

message string? - A message indicating the overall status of the webhook notification.

success boolean? - true if the webhook succeeded by receiving a 200 or 204 response.

request_headers string? - A JSON-encoded string with headers that were sent with the webhook.

request_method string? - The HTTP verb used to perform the webhook.

request_url string? - The webhook request URL.

path string? - The path to the actual file that triggered this notification.

folder string? - The folder associated with the triggering action for this notification.

files.com: ActionNotificationExportsBody

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

start_at string? - Start date/time of export range.

end_at string? - End date/time of export range.

query_message string? - Error message associated with the request, if any.

query_request_method string? - The HTTP request method used by the webhook.

query_request_url string? - The target webhook URL.

query_status string? - The HTTP status returned from the server in response to the webhook request.

query_success boolean? - true if the webhook request succeeded (i.e. returned a 200 or 204 response status). false otherwise.

query_path string? - Return notifications that were triggered by actions on this specific path.

query_folder string? - Return notifications that were triggered by actions in this folder.

files.com: ActionNotificationExportsBody1

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

start_at string? - Start date/time of export range.

end_at string? - End date/time of export range.

query_message string? - Error message associated with the request, if any.

query_request_method string? - The HTTP request method used by the webhook.

query_request_url string? - The target webhook URL.

query_status string? - The HTTP status returned from the server in response to the webhook request.

query_success boolean? - true if the webhook request succeeded (i.e. returned a 200 or 204 response status). false otherwise.

query_path string? - Return notifications that were triggered by actions on this specific path.

query_folder string? - Return notifications that were triggered by actions in this folder.

files.com: ActionNotificationExportsBody2

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

start_at string? - Start date/time of export range.

end_at string? - End date/time of export range.

query_message string? - Error message associated with the request, if any.

query_request_method string? - The HTTP request method used by the webhook.

query_request_url string? - The target webhook URL.

query_status string? - The HTTP status returned from the server in response to the webhook request.

query_success boolean? - true if the webhook request succeeded (i.e. returned a 200 or 204 response status). false otherwise.

query_path string? - Return notifications that were triggered by actions on this specific path.

query_folder string? - Return notifications that were triggered by actions in this folder.

files.com: ApiKeyBody

Fields

expires_at string? - API Key expiration date

name string? - Internal name for the API Key. For your use.

permission_set string? - Permissions for this API Key. Keys with the desktop_app permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations). Additional permission sets may become available in the future, such as for a Site Admin to give a key with no administrator privileges. If you have ideas for permission sets, please let us know.

files.com: ApiKeyBody1

Fields

expires_at string? - API Key expiration date

name string? - Internal name for the API Key. For your use.

permission_set string? - Permissions for this API Key. Keys with the desktop_app permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations). Additional permission sets may become available in the future, such as for a Site Admin to give a key with no administrator privileges. If you have ideas for permission sets, please let us know.

files.com: ApiKeyBody2

Fields

expires_at string? - API Key expiration date

name string? - Internal name for the API Key. For your use.

permission_set string? - Permissions for this API Key. Keys with the desktop_app permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations). Additional permission sets may become available in the future, such as for a Site Admin to give a key with no administrator privileges. If you have ideas for permission sets, please let us know.

files.com: ApiKeyEntity

List Api Keys

Fields

id int? - API Key ID

descriptive_label string? - Unique label that describes this API key. Useful for external systems where you may have API keys from multiple accounts and want a human-readable label for each key.

created_at string? - Time which API Key was created

expires_at string? - API Key expiration date

'key string? - API Key actual key string

last_use_at string? - API Key last used - note this value is only updated once per 3 hour period, so the 'actual' time of last use may be up to 3 hours later than this timestamp.

name string? - Internal name for the API Key. For your use.

path string? - Folder path restriction for this api key.

permission_set string? - Permissions for this API Key. Keys with the desktop_app permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations). Additional permission sets may become available in the future, such as for a Site Admin to give a key with no administrator privileges. If you have ideas for permission sets, please let us know.

platform string? - If this API key represents a Desktop app, what platform was it created on?

user_id int? - User ID for the owner of this API Key. May be blank for Site-wide API Keys.

files.com: ApiKeysBody

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

name string? - Internal name for the API Key. For your use.

expires_at string? - API Key expiration date

permission_set string? - Permissions for this API Key. Keys with the desktop_app permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations). Additional permission sets may become available in the future, such as for a Site Admin to give a key with no administrator privileges. If you have ideas for permission sets, please let us know.

path string? - Folder path restriction for this api key.

files.com: ApiKeysBody1

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

name string? - Internal name for the API Key. For your use.

expires_at string? - API Key expiration date

permission_set string? - Permissions for this API Key. Keys with the desktop_app permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations). Additional permission sets may become available in the future, such as for a Site Admin to give a key with no administrator privileges. If you have ideas for permission sets, please let us know.

path string? - Folder path restriction for this api key.

files.com: ApiKeysBody2

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

name string? - Internal name for the API Key. For your use.

expires_at string? - API Key expiration date

permission_set string? - Permissions for this API Key. Keys with the desktop_app permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations). Additional permission sets may become available in the future, such as for a Site Admin to give a key with no administrator privileges. If you have ideas for permission sets, please let us know.

path string? - Folder path restriction for this api key.

files.com: ApiKeysConfig

Closed record

Provides API key configurations needed when communicating with a remote HTTP endpoint.

Fields

xFilesapiKey string - API Key - supports user-based or site-wide API keys

files.com: ApiKeysIdBody

Fields

name string? - Internal name for the API Key. For your use.

expires_at string? - API Key expiration date

permission_set string? - Permissions for this API Key. Keys with the desktop_app permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations). Additional permission sets may become available in the future, such as for a Site Admin to give a key with no administrator privileges. If you have ideas for permission sets, please let us know.

files.com: ApiKeysIdBody1

Fields

name string? - Internal name for the API Key. For your use.

expires_at string? - API Key expiration date

permission_set string? - Permissions for this API Key. Keys with the desktop_app permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations). Additional permission sets may become available in the future, such as for a Site Admin to give a key with no administrator privileges. If you have ideas for permission sets, please let us know.

files.com: ApiKeysIdBody2

Fields

name string? - Internal name for the API Key. For your use.

expires_at string? - API Key expiration date

permission_set string? - Permissions for this API Key. Keys with the desktop_app permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations). Additional permission sets may become available in the future, such as for a Site Admin to give a key with no administrator privileges. If you have ideas for permission sets, please let us know.

files.com: AppEntity

List Apps

Fields

name string? - Name of the App

extended_description string? - Long form description of the App

short_description string? - Short description of the App

documentation_links string? - Collection of named links to documentation

icon_url string? - App icon

logo_url string? - Full size logo for the App

screenshot_list_urls string? - Screenshots of the App

logo_thumbnail_url string? - Logo thumbnail for the App

sso_strategy_type string? - Associated SSO Strategy type, if any

remote_server_type string? - Associated Remote Server type, if any

folder_behavior_type string? - Associated Folder Behavior type, if any

external_homepage_url string? - Link to external homepage

marketing_youtube_url string? - Marketing video page

tutorial_youtube_url string? - Tutorial video page

app_type string? - The type of the App

featured boolean? - Is featured on the App listing?

files.com: As2KeyEntity

List As2 Keys

Fields

id int? - AS2 Key ID

as2_partnership_name string? - AS2 Partnership Name

created_at string? - AS2 Key created at date/time

fingerprint string? - Public key fingerprint

files.com: As2KeysBody

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

as2_partnership_name string - AS2 Partnership Name

public_key string - Actual contents of Public key.

files.com: As2KeysBody1

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

as2_partnership_name string - AS2 Partnership Name

public_key string - Actual contents of Public key.

files.com: As2KeysBody2

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

as2_partnership_name string - AS2 Partnership Name

public_key string - Actual contents of Public key.

files.com: As2KeysIdBody

Fields

as2_partnership_name string - AS2 Partnership Name

files.com: As2KeysIdBody1

Fields

as2_partnership_name string - AS2 Partnership Name

files.com: As2KeysIdBody2

Fields

as2_partnership_name string - AS2 Partnership Name

files.com: AutoEntity

Auto fields.

Fields

dynamic record {}? - Dynamic properties

files.com: AutomationEntity

List Automations

Fields

id int? - Automation ID

automation string? - Automation type

trigger string? - How this automation is triggered to run. One of: realtime, daily, custom_schedule, webhook, email, or action.

interval string? - If trigger is daily, this specifies how often to run this automation. One of: day, week, week_end, month, month_end, quarter, quarter_end, year, year_end

schedule record {}? - If trigger is custom_schedule, Custom schedule description for when the automation should be run.

'source string? - Source Path

destinations string? - Destination Path

destination_replace_from string? - If set, this string in the destination path will be replaced with the value in destination_replace_to.

destination_replace_to string? - If set, this string will replace the value destination_replace_from in the destination filename. You can use special patterns here.

path string? - Path on which this Automation runs. Supports globs.

user_id int? - User ID of the Automation's creator.

user_ids int[]? - IDs of Users for the Automation (i.e. who to Request File from)

group_ids int[]? - IDs of Groups for the Automation (i.e. who to Request File from)

webhook_url string? - If trigger is webhook, this is the URL of the webhook to trigger the Automation.

trigger_actions string? - If trigger is action, this is the list of action types on which to trigger the automation. Valid actions are create, read, update, destroy, move, copy

trigger_action_path string? - If trigger is action, this is the path to watch for the specified trigger actions.

value record {}? - A Hash of attributes specific to the automation type.

files.com: AutomationsBody

Fields

automation string - Automation type

'source string? - Source Path

destination string? - DEPRECATED: Destination Path. Use destinations instead.

destinations string[]? - A list of String destination paths or Hash of folder_path and optional file_path.

destination_replace_from string? - If set, this string in the destination path will be replaced with the value in destination_replace_to.

destination_replace_to string? - If set, this string will replace the value destination_replace_from in the destination filename. You can use special patterns here.

interval string? - How often to run this automation? One of: day, week, week_end, month, month_end, quarter, quarter_end, year, year_end

path string? - Path on which this Automation runs. Supports globs.

user_ids string? - A list of user IDs the automation is associated with. If sent as a string, it should be comma-delimited.

group_ids string? - A list of group IDs the automation is associated with. If sent as a string, it should be comma-delimited.

schedule record {}? - Custom schedule for running this automation.

trigger string? - How this automation is triggered to run. One of: realtime, daily, custom_schedule, webhook, email, or action.

trigger_actions string[]? - If trigger is action, this is the list of action types on which to trigger the automation. Valid actions are create, read, update, destroy, move, copy

trigger_action_path string? - If trigger is action, this is the path to watch for the specified trigger actions.

value record {}? - A Hash of attributes specific to the automation type.

files.com: AutomationsBody1

Fields

automation string - Automation type

'source string? - Source Path

destination string? - DEPRECATED: Destination Path. Use destinations instead.

destinations string[]? - A list of String destination paths or Hash of folder_path and optional file_path.

destination_replace_from string? - If set, this string in the destination path will be replaced with the value in destination_replace_to.

destination_replace_to string? - If set, this string will replace the value destination_replace_from in the destination filename. You can use special patterns here.

interval string? - How often to run this automation? One of: day, week, week_end, month, month_end, quarter, quarter_end, year, year_end

path string? - Path on which this Automation runs. Supports globs.

user_ids string? - A list of user IDs the automation is associated with. If sent as a string, it should be comma-delimited.

group_ids string? - A list of group IDs the automation is associated with. If sent as a string, it should be comma-delimited.

schedule record {}? - Custom schedule for running this automation.

trigger string? - How this automation is triggered to run. One of: realtime, daily, custom_schedule, webhook, email, or action.

trigger_actions string[]? - If trigger is action, this is the list of action types on which to trigger the automation. Valid actions are create, read, update, destroy, move, copy

trigger_action_path string? - If trigger is action, this is the path to watch for the specified trigger actions.

value record {}? - A Hash of attributes specific to the automation type.

files.com: AutomationsBody2

Fields

automation string - Automation type

'source string? - Source Path

destination string? - DEPRECATED: Destination Path. Use destinations instead.

destinations string[]? - A list of String destination paths or Hash of folder_path and optional file_path.

destination_replace_from string? - If set, this string in the destination path will be replaced with the value in destination_replace_to.

destination_replace_to string? - If set, this string will replace the value destination_replace_from in the destination filename. You can use special patterns here.

interval string? - How often to run this automation? One of: day, week, week_end, month, month_end, quarter, quarter_end, year, year_end

path string? - Path on which this Automation runs. Supports globs.

user_ids string? - A list of user IDs the automation is associated with. If sent as a string, it should be comma-delimited.

group_ids string? - A list of group IDs the automation is associated with. If sent as a string, it should be comma-delimited.

schedule record {}? - Custom schedule for running this automation.

trigger string? - How this automation is triggered to run. One of: realtime, daily, custom_schedule, webhook, email, or action.

trigger_actions string[]? - If trigger is action, this is the list of action types on which to trigger the automation. Valid actions are create, read, update, destroy, move, copy

trigger_action_path string? - If trigger is action, this is the path to watch for the specified trigger actions.

value record {}? - A Hash of attributes specific to the automation type.

files.com: AutomationsIdBody

Fields

automation string - Automation type

'source string? - Source Path

destination string? - DEPRECATED: Destination Path. Use destinations instead.

destinations string[]? - A list of String destination paths or Hash of folder_path and optional file_path.

destination_replace_from string? - If set, this string in the destination path will be replaced with the value in destination_replace_to.

destination_replace_to string? - If set, this string will replace the value destination_replace_from in the destination filename. You can use special patterns here.

interval string? - How often to run this automation? One of: day, week, week_end, month, month_end, quarter, quarter_end, year, year_end

path string? - Path on which this Automation runs. Supports globs.

user_ids string? - A list of user IDs the automation is associated with. If sent as a string, it should be comma-delimited.

group_ids string? - A list of group IDs the automation is associated with. If sent as a string, it should be comma-delimited.

schedule record {}? - Custom schedule for running this automation.

trigger string? - How this automation is triggered to run. One of: realtime, daily, custom_schedule, webhook, email, or action.

trigger_actions string[]? - If trigger is action, this is the list of action types on which to trigger the automation. Valid actions are create, read, update, destroy, move, copy

trigger_action_path string? - If trigger is action, this is the path to watch for the specified trigger actions.

value record {}? - A Hash of attributes specific to the automation type.

files.com: AutomationsIdBody1

Fields

automation string - Automation type

'source string? - Source Path

destination string? - DEPRECATED: Destination Path. Use destinations instead.

destinations string[]? - A list of String destination paths or Hash of folder_path and optional file_path.

destination_replace_from string? - If set, this string in the destination path will be replaced with the value in destination_replace_to.

destination_replace_to string? - If set, this string will replace the value destination_replace_from in the destination filename. You can use special patterns here.

interval string? - How often to run this automation? One of: day, week, week_end, month, month_end, quarter, quarter_end, year, year_end

path string? - Path on which this Automation runs. Supports globs.

user_ids string? - A list of user IDs the automation is associated with. If sent as a string, it should be comma-delimited.

group_ids string? - A list of group IDs the automation is associated with. If sent as a string, it should be comma-delimited.

schedule record {}? - Custom schedule for running this automation.

trigger string? - How this automation is triggered to run. One of: realtime, daily, custom_schedule, webhook, email, or action.

trigger_actions string[]? - If trigger is action, this is the list of action types on which to trigger the automation. Valid actions are create, read, update, destroy, move, copy

trigger_action_path string? - If trigger is action, this is the path to watch for the specified trigger actions.

value record {}? - A Hash of attributes specific to the automation type.

files.com: AutomationsIdBody2

Fields

automation string - Automation type

'source string? - Source Path

destination string? - DEPRECATED: Destination Path. Use destinations instead.

destinations string[]? - A list of String destination paths or Hash of folder_path and optional file_path.

destination_replace_from string? - If set, this string in the destination path will be replaced with the value in destination_replace_to.

destination_replace_to string? - If set, this string will replace the value destination_replace_from in the destination filename. You can use special patterns here.

interval string? - How often to run this automation? One of: day, week, week_end, month, month_end, quarter, quarter_end, year, year_end

path string? - Path on which this Automation runs. Supports globs.

user_ids string? - A list of user IDs the automation is associated with. If sent as a string, it should be comma-delimited.

group_ids string? - A list of group IDs the automation is associated with. If sent as a string, it should be comma-delimited.

schedule record {}? - Custom schedule for running this automation.

trigger string? - How this automation is triggered to run. One of: realtime, daily, custom_schedule, webhook, email, or action.

trigger_actions string[]? - If trigger is action, this is the list of action types on which to trigger the automation. Valid actions are create, read, update, destroy, move, copy

trigger_action_path string? - If trigger is action, this is the path to watch for the specified trigger actions.

value record {}? - A Hash of attributes specific to the automation type.

files.com: BandwidthSnapshotEntity

List Bandwidth Snapshots

Fields

id int? - Site bandwidth ID

bytes_received decimal? - Site bandwidth report bytes received

bytes_sent decimal? - Site bandwidth report bytes sent

sync_bytes_received decimal? - Site sync bandwidth report bytes received

sync_bytes_sent decimal? - Site sync bandwidth report bytes sent

requests_get decimal? - Site bandwidth report get requests

requests_put decimal? - Site bandwidth report put requests

requests_other decimal? - Site bandwidth report other requests

logged_at string? - Time the site bandwidth report was logged

created_at string? - Site bandwidth report created at date/time

updated_at string? - The last time this site bandwidth report was updated

files.com: BeginUploadFilepathBody

Fields

mkdir_parents boolean? - Create parent directories if they do not exist?

part int? - Part if uploading a part.

parts int? - How many parts to fetch?

ref string? -

restart int? - File byte offset to restart from.

with_rename boolean? - Allow file rename instead of overwrite?

files.com: BeginUploadFilepathBody1

Fields

mkdir_parents boolean? - Create parent directories if they do not exist?

part int? - Part if uploading a part.

parts int? - How many parts to fetch?

ref string? -

restart int? - File byte offset to restart from.

with_rename boolean? - Allow file rename instead of overwrite?

files.com: BeginUploadFilepathBody2

Fields

mkdir_parents boolean? - Create parent directories if they do not exist?

part int? - Part if uploading a part.

parts int? - How many parts to fetch?

ref string? -

restart int? - File byte offset to restart from.

with_rename boolean? - Allow file rename instead of overwrite?

files.com: BehaviorEntity

List Behaviors

Fields

id int? - Folder behavior ID

path string? - Folder path

attachment_url string? - URL for attached file

behavior string? - Behavior type.

value record {}? - Settings for this behavior. See the section above for an example value to provide here. Formatting is different for each Behavior type. May be sent as nested JSON or a single JSON-encoded string. If using XML encoding for the API call, this data must be sent as a JSON-encoded string.

files.com: BehaviorsBody

Fields

value string? - The value of the folder behavior. Can be a integer, array, or hash depending on the type of folder behavior. See The Behavior Types section for example values for each type of behavior.

attachment_file string? - Certain behaviors may require a file, for instance, the "watermark" behavior requires a watermark image

path string - Folder behaviors path.

behavior string - Behavior type.

files.com: BehaviorsBody1

Fields

value string? - The value of the folder behavior. Can be a integer, array, or hash depending on the type of folder behavior. See The Behavior Types section for example values for each type of behavior.

attachment_file string? - Certain behaviors may require a file, for instance, the "watermark" behavior requires a watermark image

path string - Folder behaviors path.

behavior string - Behavior type.

files.com: BehaviorsBody2

Fields

value string? - The value of the folder behavior. Can be a integer, array, or hash depending on the type of folder behavior. See The Behavior Types section for example values for each type of behavior.

attachment_file string? - Certain behaviors may require a file, for instance, the "watermark" behavior requires a watermark image

path string - Folder behaviors path.

behavior string - Behavior type.

files.com: BehaviorsIdBody

Fields

value string? - The value of the folder behavior. Can be a integer, array, or hash depending on the type of folder behavior. See The Behavior Types section for example values for each type of behavior.

attachment_file string? - Certain behaviors may require a file, for instance, the "watermark" behavior requires a watermark image

behavior string? - Behavior type.

path string? - Folder behaviors path.

files.com: BehaviorsIdBody1

Fields

value string? - The value of the folder behavior. Can be a integer, array, or hash depending on the type of folder behavior. See The Behavior Types section for example values for each type of behavior.

attachment_file string? - Certain behaviors may require a file, for instance, the "watermark" behavior requires a watermark image

behavior string? - Behavior type.

path string? - Folder behaviors path.

files.com: BehaviorsIdBody2

Fields

value string? - The value of the folder behavior. Can be a integer, array, or hash depending on the type of folder behavior. See The Behavior Types section for example values for each type of behavior.

attachment_file string? - Certain behaviors may require a file, for instance, the "watermark" behavior requires a watermark image

behavior string? - Behavior type.

path string? - Folder behaviors path.

files.com: BundleDownloadEntity

List Bundle Downloads

Fields

bundle_registration BundleRegistrationEntity? - List Bundle Registrations

download_method string? - Download method (file or full_zip)

path string? - Download path

created_at string? - Download date/time

files.com: BundleEntity

Create Bundle

Fields

code string? - Bundle code. This code forms the end part of the Public URL.

url string? - Public URL of Share Link

description string? - Public description

password_protected boolean? - Is this bundle password protected?

preview_only boolean? - Restrict users to previewing files only?

require_registration boolean? - Show a registration page that captures the downloader's name and email address?

require_share_recipient boolean? - Only allow access to recipients who have explicitly received the share via an email sent through the Files.com UI?

clickwrap_body string? - Legal text that must be agreed to prior to accessing Bundle.

form_field_set FormFieldSetEntity? - Create Form Field Set

id int? - Bundle ID

created_at string? - Bundle created at date/time

expires_at string? - Bundle expiration date/time

max_uses int? - Maximum number of times bundle can be accessed

note string? - Bundle internal note

user_id int? - Bundle creator user ID

username string? - Bundle creator username

clickwrap_id int? - ID of the clickwrap to use with this bundle.

inbox_id int? - ID of the associated inbox, if available.

has_inbox boolean? - Does this bundle have an associated inbox?

paths string[]? - A list of paths in this bundle

files.com: BundleRecipientEntity

List Bundle Recipients

Fields

company string? - The recipient's company.

name string? - The recipient's name.

note string? - A note sent to the recipient with the bundle.

recipient string? - The recipient's email address.

sent_at string? - When the Bundle was shared with this recipient.

files.com: BundleRecipientsBody

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

bundle_id int - Bundle to share.

recipient string - Email addresses to share this bundle with.

name string? - Name of recipient.

company string? - Company of recipient.

note string? - Note to include in email.

share_after_create boolean? - Set to true to share the link with the recipient upon creation.

files.com: BundleRecipientsBody1

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

bundle_id int - Bundle to share.

recipient string - Email addresses to share this bundle with.

name string? - Name of recipient.

company string? - Company of recipient.

note string? - Note to include in email.

share_after_create boolean? - Set to true to share the link with the recipient upon creation.

files.com: BundleRecipientsBody2

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

bundle_id int - Bundle to share.

recipient string - Email addresses to share this bundle with.

name string? - Name of recipient.

company string? - Company of recipient.

note string? - Note to include in email.

share_after_create boolean? - Set to true to share the link with the recipient upon creation.

files.com: BundleRegistrationEntity

List Bundle Registrations

Fields

code string? - Registration cookie code

name string? - Registrant name

company string? - Registrant company name

email string? - Registrant email address

ip string? - Registrant IP Address

inbox_code string? - InboxRegistration cookie code, if there is an associated InboxRegistration

clickwrap_body string? - Clickwrap text that was shown to the registrant

form_field_set_id int? - Id of associated form field set

form_field_data string? - Data for form field set with form field ids as keys and user data as values

files.com: BundlesBody

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

paths string[] - A list of paths to include in this bundle.

password string? - Password for this bundle.

form_field_set_id int? - Id of Form Field Set to use with this bundle

expires_at string? - Bundle expiration date/time

max_uses int? - Maximum number of times bundle can be accessed

description string? - Public description

note string? - Bundle internal note

code string? - Bundle code. This code forms the end part of the Public URL.

preview_only boolean? - Restrict users to previewing files only?

require_registration boolean? - Show a registration page that captures the downloader's name and email address?

clickwrap_id int? - ID of the clickwrap to use with this bundle.

inbox_id int? - ID of the associated inbox, if available.

require_share_recipient boolean? - Only allow access to recipients who have explicitly received the share via an email sent through the Files.com UI?

files.com: BundlesBody1

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

paths string[] - A list of paths to include in this bundle.

password string? - Password for this bundle.

form_field_set_id int? - Id of Form Field Set to use with this bundle

expires_at string? - Bundle expiration date/time

max_uses int? - Maximum number of times bundle can be accessed

description string? - Public description

note string? - Bundle internal note

code string? - Bundle code. This code forms the end part of the Public URL.

preview_only boolean? - Restrict users to previewing files only?

require_registration boolean? - Show a registration page that captures the downloader's name and email address?

clickwrap_id int? - ID of the clickwrap to use with this bundle.

inbox_id int? - ID of the associated inbox, if available.

require_share_recipient boolean? - Only allow access to recipients who have explicitly received the share via an email sent through the Files.com UI?

files.com: BundlesBody2

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

paths string[] - A list of paths to include in this bundle.

password string? - Password for this bundle.

form_field_set_id int? - Id of Form Field Set to use with this bundle

expires_at string? - Bundle expiration date/time

max_uses int? - Maximum number of times bundle can be accessed

description string? - Public description

note string? - Bundle internal note

code string? - Bundle code. This code forms the end part of the Public URL.

preview_only boolean? - Restrict users to previewing files only?

require_registration boolean? - Show a registration page that captures the downloader's name and email address?

clickwrap_id int? - ID of the clickwrap to use with this bundle.

inbox_id int? - ID of the associated inbox, if available.

require_share_recipient boolean? - Only allow access to recipients who have explicitly received the share via an email sent through the Files.com UI?

files.com: BundlesIdBody

Fields

paths string[]? - A list of paths to include in this bundle.

password string? - Password for this bundle.

form_field_set_id int? - Id of Form Field Set to use with this bundle

clickwrap_id int? - ID of the clickwrap to use with this bundle.

code string? - Bundle code. This code forms the end part of the Public URL.

description string? - Public description

expires_at string? - Bundle expiration date/time

inbox_id int? - ID of the associated inbox, if available.

max_uses int? - Maximum number of times bundle can be accessed

note string? - Bundle internal note

preview_only boolean? - Restrict users to previewing files only?

require_registration boolean? - Show a registration page that captures the downloader's name and email address?

require_share_recipient boolean? - Only allow access to recipients who have explicitly received the share via an email sent through the Files.com UI?

files.com: BundlesIdBody1

Fields

paths string[]? - A list of paths to include in this bundle.

password string? - Password for this bundle.

form_field_set_id int? - Id of Form Field Set to use with this bundle

clickwrap_id int? - ID of the clickwrap to use with this bundle.

code string? - Bundle code. This code forms the end part of the Public URL.

description string? - Public description

expires_at string? - Bundle expiration date/time

inbox_id int? - ID of the associated inbox, if available.

max_uses int? - Maximum number of times bundle can be accessed

note string? - Bundle internal note

preview_only boolean? - Restrict users to previewing files only?

require_registration boolean? - Show a registration page that captures the downloader's name and email address?

require_share_recipient boolean? - Only allow access to recipients who have explicitly received the share via an email sent through the Files.com UI?

files.com: BundlesIdBody2

Fields

paths string[]? - A list of paths to include in this bundle.

password string? - Password for this bundle.

form_field_set_id int? - Id of Form Field Set to use with this bundle

clickwrap_id int? - ID of the clickwrap to use with this bundle.

code string? - Bundle code. This code forms the end part of the Public URL.

description string? - Public description

expires_at string? - Bundle expiration date/time

inbox_id int? - ID of the associated inbox, if available.

max_uses int? - Maximum number of times bundle can be accessed

note string? - Bundle internal note

preview_only boolean? - Restrict users to previewing files only?

require_registration boolean? - Show a registration page that captures the downloader's name and email address?

require_share_recipient boolean? - Only allow access to recipients who have explicitly received the share via an email sent through the Files.com UI?

files.com: ClickwrapEntity

Create Clickwrap

Fields

id int? - Clickwrap ID

name string? - Name of the Clickwrap agreement (used when selecting from multiple Clickwrap agreements.)

body string? - Body text of Clickwrap (supports Markdown formatting).

use_with_users string? - Use this Clickwrap for User Registrations? Note: This only applies to User Registrations where the User is invited to your Files.com site using an E-Mail invitation process where they then set their own password.

use_with_bundles string? - Use this Clickwrap for Bundles?

use_with_inboxes string? - Use this Clickwrap for Inboxes?

files.com: ClickwrapsBody

Fields

name string? - Name of the Clickwrap agreement (used when selecting from multiple Clickwrap agreements.)

body string? - Body text of Clickwrap (supports Markdown formatting).

use_with_bundles string? - Use this Clickwrap for Bundles?

use_with_inboxes string? - Use this Clickwrap for Inboxes?

use_with_users string? - Use this Clickwrap for User Registrations? Note: This only applies to User Registrations where the User is invited to your Files.com site using an E-Mail invitation process where they then set their own password.

files.com: ClickwrapsBody1

Fields

name string? - Name of the Clickwrap agreement (used when selecting from multiple Clickwrap agreements.)

body string? - Body text of Clickwrap (supports Markdown formatting).

use_with_bundles string? - Use this Clickwrap for Bundles?

use_with_inboxes string? - Use this Clickwrap for Inboxes?

use_with_users string? - Use this Clickwrap for User Registrations? Note: This only applies to User Registrations where the User is invited to your Files.com site using an E-Mail invitation process where they then set their own password.

files.com: ClickwrapsBody2

Fields

name string? - Name of the Clickwrap agreement (used when selecting from multiple Clickwrap agreements.)

body string? - Body text of Clickwrap (supports Markdown formatting).

use_with_bundles string? - Use this Clickwrap for Bundles?

use_with_inboxes string? - Use this Clickwrap for Inboxes?

use_with_users string? - Use this Clickwrap for User Registrations? Note: This only applies to User Registrations where the User is invited to your Files.com site using an E-Mail invitation process where they then set their own password.

files.com: ClickwrapsIdBody

Fields

name string? - Name of the Clickwrap agreement (used when selecting from multiple Clickwrap agreements.)

body string? - Body text of Clickwrap (supports Markdown formatting).

use_with_bundles string? - Use this Clickwrap for Bundles?

use_with_inboxes string? - Use this Clickwrap for Inboxes?

use_with_users string? - Use this Clickwrap for User Registrations? Note: This only applies to User Registrations where the User is invited to your Files.com site using an E-Mail invitation process where they then set their own password.

files.com: ClickwrapsIdBody1

Fields

name string? - Name of the Clickwrap agreement (used when selecting from multiple Clickwrap agreements.)

body string? - Body text of Clickwrap (supports Markdown formatting).

use_with_bundles string? - Use this Clickwrap for Bundles?

use_with_inboxes string? - Use this Clickwrap for Inboxes?

use_with_users string? - Use this Clickwrap for User Registrations? Note: This only applies to User Registrations where the User is invited to your Files.com site using an E-Mail invitation process where they then set their own password.

files.com: ClickwrapsIdBody2

Fields

name string? - Name of the Clickwrap agreement (used when selecting from multiple Clickwrap agreements.)

body string? - Body text of Clickwrap (supports Markdown formatting).

use_with_bundles string? - Use this Clickwrap for Bundles?

use_with_inboxes string? - Use this Clickwrap for Inboxes?

use_with_users string? - Use this Clickwrap for User Registrations? Note: This only applies to User Registrations where the User is invited to your Files.com site using an E-Mail invitation process where they then set their own password.

files.com: 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

files.com: ConnectionConfig

Closed record

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

Fields

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

files.com: CopyFilepathBody

Fields

destination string - Copy destination path.

structure boolean? - Copy structure only?

files.com: CopyFilepathBody1

Fields

destination string - Copy destination path.

structure boolean? - Copy structure only?

files.com: CopyFilepathBody2

Fields

destination string - Copy destination path.

structure boolean? - Copy structure only?

files.com: DnsRecordEntity

Show site DNS configuration.

Fields

id string? - Unique label for DNS record; used by Zapier and other integrations.

domain string? - DNS record domain name

rrtype string? - DNS record type

value string? - DNS record value

files.com: ErrorsEntity

Error fields.

Fields

fields string[]? - A list of fields where errors occur

messages string[]? - A list of error messages

files.com: ExternalEventEntity

List External Events

Fields

id int? - Event ID

event_type string? - Type of event being recorded.

status string? - Status of event.

body string? - Event body

created_at string? - External event create date/time

body_url string? - Link to log file.

folder_behavior_id int? - Folder Behavior ID

successful_files int? - For sync events, the number of files handled successfully.

errored_files int? - For sync events, the number of files that encountered errors.

bytes_synced int? - For sync events, the total number of bytes synced.

remote_server_type string? - Associated Remote Server type, if any

files.com: ExternalEventsBody

Fields

status string - Status of event.

body string - Event body

files.com: ExternalEventsBody1

Fields

status string - Status of event.

body string - Event body

files.com: ExternalEventsBody2

Fields

status string - Status of event.

body string - Event body

files.com: FileActionEntity

Move file/folder

Fields

status string? - Status of file operation. Possible values: completed, enqueued.

file_migration_id int? - If status is enqueued, this is the id of the FileMigration to check for status updates.

files.com: FileCommentEntity

List File Comments by path

Fields

id int? - File Comment ID

body string? - Comment body.

reactions FileCommentReactionEntity? - Create File Comment Reaction

files.com: FileCommentReactionEntity

Create File Comment Reaction

Fields

id int? - Reaction ID

emoji string? - Emoji used in the reaction.

files.com: FileCommentReactionsBody

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

file_comment_id int - ID of file comment to attach reaction to.

emoji string - Emoji to react with.

files.com: FileCommentReactionsBody1

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

file_comment_id int - ID of file comment to attach reaction to.

emoji string - Emoji to react with.

files.com: FileCommentReactionsBody2

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

file_comment_id int - ID of file comment to attach reaction to.

emoji string - Emoji to react with.

files.com: FileCommentsBody

Fields

body string - Comment body.

path string - File path.

files.com: FileCommentsBody1

Fields

body string - Comment body.

path string - File path.

files.com: FileCommentsBody2

Fields

body string - Comment body.

path string - File path.

files.com: FileCommentsIdBody

Fields

body string - Comment body.

files.com: FileCommentsIdBody1

Fields

body string - Comment body.

files.com: FileCommentsIdBody2

Fields

body string - Comment body.

files.com: FileEntity

List Folders by path

Fields

path string? - File/Folder path

display_name string? - File/Folder display name

'type string? - Type: directory or file.

size int? - File/Folder size

mtime string? - File last modified date/time, according to the server. This is the timestamp of the last Files.com operation of the file, regardless of what modified timestamp was sent.

provided_mtime string? - File last modified date/time, according to the client who set it. Files.com allows desktop, FTP, SFTP, and WebDAV clients to set modified at times. This allows Desktop<->Cloud syncing to preserve modified at times.

crc32 string? - File CRC32 checksum. This is sometimes delayed, so if you get a blank response, wait and try again.

md5 string? - File MD5 checksum. This is sometimes delayed, so if you get a blank response, wait and try again.

mime_type string? - MIME Type. This is determined by the filename extension and is not stored separately internally.

region string? - Region location

permissions string? - A short string representing the current user's permissions. Can be r,w,p, or any combination

subfolders_locked boolean? - Are subfolders locked and unable to be modified?

download_uri string? - Link to download file. Provided only in response to a download request.

priority_color string? - Bookmark/priority color of file/folder

preview_id int? - File preview ID

preview PreviewEntity? - File preview

files.com: FileMigrationEntity

Show File Migration

Fields

id int? - File migration ID

path string? - Source path

dest_path string? - Destination path

files_moved int? - Number of files processed

files_total int? - Total number of files to process

operation string? - The type of operation

region string? - Region

status string? - Status

log_url string? - Link to download the log file for this migration.

files.com: FilesFilepathBody

Fields

action string? - The action to perform. Can be append, attachment, end, upload, put, or may not exist

'etags\[etag\] string[] - etag identifier.

'etags\[part\] int[] - Part number.

length int? - Length of file.

mkdir_parents boolean? - Create parent directories if they do not exist?

part int? - Part if uploading a part.

parts int? - How many parts to fetch?

provided_mtime string? - User provided modification time.

ref string? -

restart int? - File byte offset to restart from.

size int? - Size of file.

structure string? - If copying folder, copy just the structure?

with_rename boolean? - Allow file rename instead of overwrite?

files.com: FilesFilepathBody1

Fields

action string? - The action to perform. Can be append, attachment, end, upload, put, or may not exist

'etags\[etag\] string[] - etag identifier.

'etags\[part\] int[] - Part number.

length int? - Length of file.

mkdir_parents boolean? - Create parent directories if they do not exist?

part int? - Part if uploading a part.

parts int? - How many parts to fetch?

provided_mtime string? - User provided modification time.

ref string? -

restart int? - File byte offset to restart from.

size int? - Size of file.

structure string? - If copying folder, copy just the structure?

with_rename boolean? - Allow file rename instead of overwrite?

files.com: FilesFilepathBody2

Fields

action string? - The action to perform. Can be append, attachment, end, upload, put, or may not exist

'etags\[etag\] string[] - etag identifier.

'etags\[part\] int[] - Part number.

length int? - Length of file.

mkdir_parents boolean? - Create parent directories if they do not exist?

part int? - Part if uploading a part.

parts int? - How many parts to fetch?

provided_mtime string? - User provided modification time.

ref string? -

restart int? - File byte offset to restart from.

size int? - Size of file.

structure string? - If copying folder, copy just the structure?

with_rename boolean? - Allow file rename instead of overwrite?

files.com: FilesFilepathBody3

Fields

provided_mtime string? - Modified time of file.

priority_color string? - Priority/Bookmark color of file.

files.com: FilesFilepathBody4

Fields

provided_mtime string? - Modified time of file.

priority_color string? - Priority/Bookmark color of file.

files.com: FilesFilepathBody5

Fields

provided_mtime string? - Modified time of file.

priority_color string? - Priority/Bookmark color of file.

files.com: FileUploadPartEntity

Begin file upload

Fields

send record {}? - Content-Type and File to send

action string? - Type of upload

ask_about_overwrites boolean? - If true, this file exists and you may wish to ask the user for overwrite confirmation

available_parts int? - Number of parts in the upload

expires string? - Date/time of when this Upload part expires and the URL cannot be used any more

headers record {}? - Additional upload headers to provide as part of the upload

http_method string? - HTTP Method to use for uploading the part, usually PUT

next_partsize int? - Size in bytes for this part

parallel_parts boolean? - If true, multiple parts may be uploaded in parallel. If false, be sure to only upload one part at a time, in order.

parameters record {}? - Additional HTTP parameters to send with the upload

part_number int? - Number of this upload part

partsize int? - Size in bytes for the next upload part

path string? - New file path

ref string? - Reference name for this upload part

upload_uri string? - URI to upload this part to

files.com: FormFieldEntity

Form fields

Fields

id int? - Form field id

label string? - Label to be displayed

required boolean? - Is this a required field?

help_text string? - Help text to be displayed

field_type string? - Type of Field

options_for_select string? - Options to display for radio and dropdown

default_option string? - Default option for radio and dropdown

form_field_set_id int? - Form field set id

files.com: FormFieldSetEntity

Create Form Field Set

Fields

id int? - Form field set id

title string? - Title to be displayed

form_layout int? - Layout of the form

form_fields FormFieldEntity? - Form fields

skip_name boolean? - Any associated InboxRegistrations or BundleRegistrations can be saved without providing name

skip_email boolean? - Any associated InboxRegistrations or BundleRegistrations can be saved without providing email

skip_company boolean? - Any associated InboxRegistrations or BundleRegistrations can be saved without providing company

files.com: GroupEntity

List Groups

Fields

id int? - Group ID

name string? - Group name

admin_ids string? - List of user IDs who are group administrators (separated by commas)

notes string? - Notes about this group

user_ids int[]? - List of user IDs who belong to this group (separated by commas)

usernames string[]? - List of usernames who belong to this group (separated by commas)

files.com: GroupIdUsersBody

Fields

avatar_file string? - An image file for your user avatar.

avatar_delete boolean? - If true, the avatar will be deleted.

change_password string? - Used for changing a password on an existing user.

change_password_confirmation string? - Optional, but if provided, we will ensure that it matches the value sent in change_password.

email string? - User's email.

grant_permission string? - Permission to grant on the user root. Can be blank or full, read, write, list, or history.

group_ids string? - A list of group ids to associate this user with. Comma delimited.

imported_password_hash string? - Pre-calculated hash of the user's password.

password string? - User password.

password_confirmation string? - Optional, but if provided, we will ensure that it matches the value sent in password.

announcements_read boolean? - Signifies that the user has read all the announcements in the UI.

allowed_ips string? - A list of allowed IPs if applicable. Newline delimited

attachments_permission boolean? - DEPRECATED: Can the user create Bundles (aka Share Links)? Use the bundle permission instead.

authenticate_until string? - Scheduled Date/Time at which user will be deactivated

authentication_method string? - How is this user authenticated?

billing_permission boolean? - Allow this user to perform operations on the account, payments, and invoices?

bypass_inactive_disable boolean? - Exempt this user from being disabled based on inactivity?

bypass_site_allowed_ips boolean? - Allow this user to skip site-wide IP blacklists?

dav_permission boolean? - Can the user connect with WebDAV?

disabled boolean? - Is user disabled? Disabled users cannot log in, and do not count for billing purposes. Users can be automatically disabled after an inactivity period via a Site setting.

ftp_permission boolean? - Can the user access with FTP/FTPS?

header_text string? - Text to display to the user in the header of the UI

language string? - Preferred language

notification_daily_send_time int? - Hour of the day at which daily notifications should be sent. Can be in range 0 to 23

name string? - User's full name

company string? - User's company

notes string? - Any internal notes on the user

office_integration_enabled boolean? - Enable integration with Office for the web?

password_validity_days int? - Number of days to allow user to use the same password

receive_admin_alerts boolean? - Should the user receive admin alerts such a certificate expiration notifications and overages?

require_password_change boolean? - Is a password change required upon next user login?

restapi_permission boolean? - Can this user access the REST API?

self_managed boolean? - Does this user manage it's own credentials or is it a shared/bot user?

sftp_permission boolean? - Can the user access with SFTP?

site_admin boolean? - Is the user an administrator for this site?

skip_welcome_screen boolean? - Skip Welcome page in the UI?

ssl_required string? - SSL required setting

sso_strategy_id int? - SSO (Single Sign On) strategy ID for the user, if applicable.

subscribe_to_newsletter boolean? - Is the user subscribed to the newsletter?

require_2fa string? - 2FA required setting

time_zone string? - User time zone

user_root string? - Root folder for FTP (and optionally SFTP if the appropriate site-wide setting is set.) Note that this is not used for API, Desktop, or Web interface.

username string? - User's username

files.com: GroupIdUsersBody1

Fields

avatar_file string? - An image file for your user avatar.

avatar_delete boolean? - If true, the avatar will be deleted.

change_password string? - Used for changing a password on an existing user.

change_password_confirmation string? - Optional, but if provided, we will ensure that it matches the value sent in change_password.

email string? - User's email.

grant_permission string? - Permission to grant on the user root. Can be blank or full, read, write, list, or history.

group_ids string? - A list of group ids to associate this user with. Comma delimited.

imported_password_hash string? - Pre-calculated hash of the user's password.

password string? - User password.

password_confirmation string? - Optional, but if provided, we will ensure that it matches the value sent in password.

announcements_read boolean? - Signifies that the user has read all the announcements in the UI.

allowed_ips string? - A list of allowed IPs if applicable. Newline delimited

attachments_permission boolean? - DEPRECATED: Can the user create Bundles (aka Share Links)? Use the bundle permission instead.

authenticate_until string? - Scheduled Date/Time at which user will be deactivated

authentication_method string? - How is this user authenticated?

billing_permission boolean? - Allow this user to perform operations on the account, payments, and invoices?

bypass_inactive_disable boolean? - Exempt this user from being disabled based on inactivity?

bypass_site_allowed_ips boolean? - Allow this user to skip site-wide IP blacklists?

dav_permission boolean? - Can the user connect with WebDAV?

disabled boolean? - Is user disabled? Disabled users cannot log in, and do not count for billing purposes. Users can be automatically disabled after an inactivity period via a Site setting.

ftp_permission boolean? - Can the user access with FTP/FTPS?

header_text string? - Text to display to the user in the header of the UI

language string? - Preferred language

notification_daily_send_time int? - Hour of the day at which daily notifications should be sent. Can be in range 0 to 23

name string? - User's full name

company string? - User's company

notes string? - Any internal notes on the user

office_integration_enabled boolean? - Enable integration with Office for the web?

password_validity_days int? - Number of days to allow user to use the same password

receive_admin_alerts boolean? - Should the user receive admin alerts such a certificate expiration notifications and overages?

require_password_change boolean? - Is a password change required upon next user login?

restapi_permission boolean? - Can this user access the REST API?

self_managed boolean? - Does this user manage it's own credentials or is it a shared/bot user?

sftp_permission boolean? - Can the user access with SFTP?

site_admin boolean? - Is the user an administrator for this site?

skip_welcome_screen boolean? - Skip Welcome page in the UI?

ssl_required string? - SSL required setting

sso_strategy_id int? - SSO (Single Sign On) strategy ID for the user, if applicable.

subscribe_to_newsletter boolean? - Is the user subscribed to the newsletter?

require_2fa string? - 2FA required setting

time_zone string? - User time zone

user_root string? - Root folder for FTP (and optionally SFTP if the appropriate site-wide setting is set.) Note that this is not used for API, Desktop, or Web interface.

username string? - User's username

files.com: GroupIdUsersBody2

Fields

avatar_file string? - An image file for your user avatar.

avatar_delete boolean? - If true, the avatar will be deleted.

change_password string? - Used for changing a password on an existing user.

change_password_confirmation string? - Optional, but if provided, we will ensure that it matches the value sent in change_password.

email string? - User's email.

grant_permission string? - Permission to grant on the user root. Can be blank or full, read, write, list, or history.

group_ids string? - A list of group ids to associate this user with. Comma delimited.

imported_password_hash string? - Pre-calculated hash of the user's password.

password string? - User password.

password_confirmation string? - Optional, but if provided, we will ensure that it matches the value sent in password.

announcements_read boolean? - Signifies that the user has read all the announcements in the UI.

allowed_ips string? - A list of allowed IPs if applicable. Newline delimited

attachments_permission boolean? - DEPRECATED: Can the user create Bundles (aka Share Links)? Use the bundle permission instead.

authenticate_until string? - Scheduled Date/Time at which user will be deactivated

authentication_method string? - How is this user authenticated?

billing_permission boolean? - Allow this user to perform operations on the account, payments, and invoices?

bypass_inactive_disable boolean? - Exempt this user from being disabled based on inactivity?

bypass_site_allowed_ips boolean? - Allow this user to skip site-wide IP blacklists?

dav_permission boolean? - Can the user connect with WebDAV?

disabled boolean? - Is user disabled? Disabled users cannot log in, and do not count for billing purposes. Users can be automatically disabled after an inactivity period via a Site setting.

ftp_permission boolean? - Can the user access with FTP/FTPS?

header_text string? - Text to display to the user in the header of the UI

language string? - Preferred language

notification_daily_send_time int? - Hour of the day at which daily notifications should be sent. Can be in range 0 to 23

name string? - User's full name

company string? - User's company

notes string? - Any internal notes on the user

office_integration_enabled boolean? - Enable integration with Office for the web?

password_validity_days int? - Number of days to allow user to use the same password

receive_admin_alerts boolean? - Should the user receive admin alerts such a certificate expiration notifications and overages?

require_password_change boolean? - Is a password change required upon next user login?

restapi_permission boolean? - Can this user access the REST API?

self_managed boolean? - Does this user manage it's own credentials or is it a shared/bot user?

sftp_permission boolean? - Can the user access with SFTP?

site_admin boolean? - Is the user an administrator for this site?

skip_welcome_screen boolean? - Skip Welcome page in the UI?

ssl_required string? - SSL required setting

sso_strategy_id int? - SSO (Single Sign On) strategy ID for the user, if applicable.

subscribe_to_newsletter boolean? - Is the user subscribed to the newsletter?

require_2fa string? - 2FA required setting

time_zone string? - User time zone

user_root string? - Root folder for FTP (and optionally SFTP if the appropriate site-wide setting is set.) Note that this is not used for API, Desktop, or Web interface.

username string? - User's username

files.com: GroupsBody

Fields

name string? - Group name.

notes string? - Group notes.

user_ids string? - A list of user ids. If sent as a string, should be comma-delimited.

admin_ids string? - A list of group admin user ids. If sent as a string, should be comma-delimited.

files.com: GroupsBody1

Fields

name string? - Group name.

notes string? - Group notes.

user_ids string? - A list of user ids. If sent as a string, should be comma-delimited.

admin_ids string? - A list of group admin user ids. If sent as a string, should be comma-delimited.

files.com: GroupsBody2

Fields

name string? - Group name.

notes string? - Group notes.

user_ids string? - A list of user ids. If sent as a string, should be comma-delimited.

admin_ids string? - A list of group admin user ids. If sent as a string, should be comma-delimited.

files.com: GroupsIdBody

Fields

name string? - Group name.

notes string? - Group notes.

user_ids string? - A list of user ids. If sent as a string, should be comma-delimited.

admin_ids string? - A list of group admin user ids. If sent as a string, should be comma-delimited.

files.com: GroupsIdBody1

Fields

name string? - Group name.

notes string? - Group notes.

user_ids string? - A list of user ids. If sent as a string, should be comma-delimited.

admin_ids string? - A list of group admin user ids. If sent as a string, should be comma-delimited.

files.com: GroupsIdBody2

Fields

name string? - Group name.

notes string? - Group notes.

user_ids string? - A list of user ids. If sent as a string, should be comma-delimited.

admin_ids string? - A list of group admin user ids. If sent as a string, should be comma-delimited.

files.com: GroupUserEntity

Create Group User

Fields

group_name string? - Group name

group_id int? - Group ID

user_id int? - User ID

admin boolean? - Is this user an administrator of this group?

usernames string[]? - A list of usernames for users in this group

files.com: GroupUsersBody

Fields

group_id int - Group ID to add user to.

user_id int - User ID to add to group.

admin boolean? - Is the user a group administrator?

files.com: GroupUsersBody1

Fields

group_id int - Group ID to add user to.

user_id int - User ID to add to group.

admin boolean? - Is the user a group administrator?

files.com: GroupUsersBody2

Fields

group_id int - Group ID to add user to.

user_id int - User ID to add to group.

admin boolean? - Is the user a group administrator?

files.com: GroupUsersIdBody

Fields

group_id int - Group ID to add user to.

user_id int - User ID to add to group.

admin boolean? - Is the user a group administrator?

files.com: GroupUsersIdBody1

Fields

group_id int - Group ID to add user to.

user_id int - User ID to add to group.

admin boolean? - Is the user a group administrator?

files.com: GroupUsersIdBody2

Fields

group_id int - Group ID to add user to.

user_id int - User ID to add to group.

admin boolean? - Is the user a group administrator?

files.com: HistoryExportEntity

Show History Export

Fields

id int? - History Export ID

history_version string? - Version of the history for the export.

start_at string? - Start date/time of export range.

end_at string? - End date/time of export range.

status string? - Status of export. Will be: building, ready, or failed

query_action string? - Filter results by this this action type. Valid values: create, read, update, destroy, move, login, failedlogin, copy, user_create, user_update, user_destroy, group_create, group_update, group_destroy, permission_create, permission_destroy, api_key_create, api_key_update, api_key_destroy

query_interface string? - Filter results by this this interface type. Valid values: web, ftp, robot, jsapi, webdesktopapi, sftp, dav, desktop, restapi, scim, office, mobile

query_user_id string? - Return results that are actions performed by the user indiciated by this User ID

query_file_id string? - Return results that are file actions related to the file indicated by this File ID

query_parent_id string? - Return results that are file actions inside the parent folder specified by this folder ID

query_path string? - Return results that are file actions related to this path.

query_folder string? - Return results that are file actions related to files or folders inside this folder path.

query_src string? - Return results that are file moves originating from this path.

query_destination string? - Return results that are file moves with this path as destination.

query_ip string? - Filter results by this IP address.

query_username string? - Filter results by this username.

query_failure_type string? - If searching for Histories about login failures, this parameter restricts results to failures of this specific type. Valid values: expired_trial, account_overdue, locked_out, ip_mismatch, password_mismatch, site_mismatch, username_not_found, none, no_ftp_permission, no_web_permission, no_directory, errno_enoent, no_sftp_permission, no_dav_permission, no_restapi_permission, key_mismatch, region_mismatch, expired_access, desktop_ip_mismatch, desktop_api_key_not_used_quickly_enough, disabled, country_mismatch

query_target_id string? - If searching for Histories about specific objects (such as Users, or API Keys), this paremeter restricts results to objects that match this ID.

query_target_name string? - If searching for Histories about Users, Groups or other objects with names, this parameter restricts results to objects with this name/username.

query_target_permission string? - If searching for Histories about Permisisons, this parameter restricts results to permissions of this level.

query_target_user_id string? - If searching for Histories about API keys, this parameter restricts results to API keys created by/for this user ID.

query_target_username string? - If searching for Histories about API keys, this parameter restricts results to API keys created by/for this username.

query_target_platform string? - If searching for Histories about API keys, this parameter restricts results to API keys associated with this platform.

query_target_permission_set string? - If searching for Histories about API keys, this parameter restricts results to API keys with this permission set.

results_url string? - If status is ready, this will be a URL where all the results can be downloaded at once as a CSV.

files.com: HistoryExportResultEntity

List History Export Results

Fields

id int? - Action ID

created_at int? - When the action happened

user_id int? - User ID

file_id int? - File ID related to the action

parent_id int? - ID of the parent folder

path string? - Path of the related action

folder string? - Folder in which the action occurred

src string? - File move originated from this path

destination string? - File moved to this destination folder

ip string? - Client IP that performed the action

username string? - Username of the user that performed the action

action string? - What action was taken. Valid values: create, read, update, destroy, move, login, failedlogin, copy, user_create, user_update, user_destroy, group_create, group_update, group_destroy, permission_create, permission_destroy, api_key_create, api_key_update, api_key_destroy

failure_type string? - The type of login failure, if applicable. Valid values: expired_trial, account_overdue, locked_out, ip_mismatch, password_mismatch, site_mismatch, username_not_found, none, no_ftp_permission, no_web_permission, no_directory, errno_enoent, no_sftp_permission, no_dav_permission, no_restapi_permission, key_mismatch, region_mismatch, expired_access, desktop_ip_mismatch, desktop_api_key_not_used_quickly_enough, disabled, country_mismatch

interface string? - Inteface through which the action was taken. Valid values: web, ftp, robot, jsapi, webdesktopapi, sftp, dav, desktop, restapi, scim, office, mobile

target_id int? - ID of the object (such as Users, or API Keys) on which the action was taken

target_name string? - Name of the User, Group or other object with a name related to this action

target_permission string? - Permission level of the action

target_recursive boolean? - Whether or not the action was recursive

target_expires_at int? - If searching for Histories about API keys, this is when the API key will expire

target_permission_set string? - If searching for Histories about API keys, this represents the permission set of the associated API key

target_platform string? - If searching for Histories about API keys, this is the platform on which the action was taken

target_username string? - If searching for Histories about API keys, this is the username on which the action was taken

target_user_id int? - If searching for Histories about API keys, this is the User ID on which the action was taken

files.com: HistoryExportsBody

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

start_at string? - Start date/time of export range.

end_at string? - End date/time of export range.

query_action string? - Filter results by this this action type. Valid values: create, read, update, destroy, move, login, failedlogin, copy, user_create, user_update, user_destroy, group_create, group_update, group_destroy, permission_create, permission_destroy, api_key_create, api_key_update, api_key_destroy

query_interface string? - Filter results by this this interface type. Valid values: web, ftp, robot, jsapi, webdesktopapi, sftp, dav, desktop, restapi, scim, office, mobile

query_user_id string? - Return results that are actions performed by the user indiciated by this User ID

query_file_id string? - Return results that are file actions related to the file indicated by this File ID

query_parent_id string? - Return results that are file actions inside the parent folder specified by this folder ID

query_path string? - Return results that are file actions related to this path.

query_folder string? - Return results that are file actions related to files or folders inside this folder path.

query_src string? - Return results that are file moves originating from this path.

query_destination string? - Return results that are file moves with this path as destination.

query_ip string? - Filter results by this IP address.

query_username string? - Filter results by this username.

query_failure_type string? - If searching for Histories about login failures, this parameter restricts results to failures of this specific type. Valid values: expired_trial, account_overdue, locked_out, ip_mismatch, password_mismatch, site_mismatch, username_not_found, none, no_ftp_permission, no_web_permission, no_directory, errno_enoent, no_sftp_permission, no_dav_permission, no_restapi_permission, key_mismatch, region_mismatch, expired_access, desktop_ip_mismatch, desktop_api_key_not_used_quickly_enough, disabled, country_mismatch

query_target_id string? - If searching for Histories about specific objects (such as Users, or API Keys), this paremeter restricts results to objects that match this ID.

query_target_name string? - If searching for Histories about Users, Groups or other objects with names, this parameter restricts results to objects with this name/username.

query_target_permission string? - If searching for Histories about Permisisons, this parameter restricts results to permissions of this level.

query_target_user_id string? - If searching for Histories about API keys, this parameter restricts results to API keys created by/for this user ID.

query_target_username string? - If searching for Histories about API keys, this parameter restricts results to API keys created by/for this username.

query_target_platform string? - If searching for Histories about API keys, this parameter restricts results to API keys associated with this platform.

query_target_permission_set string? - If searching for Histories about API keys, this parameter restricts results to API keys with this permission set.

files.com: HistoryExportsBody1

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

start_at string? - Start date/time of export range.

end_at string? - End date/time of export range.

query_action string? - Filter results by this this action type. Valid values: create, read, update, destroy, move, login, failedlogin, copy, user_create, user_update, user_destroy, group_create, group_update, group_destroy, permission_create, permission_destroy, api_key_create, api_key_update, api_key_destroy

query_interface string? - Filter results by this this interface type. Valid values: web, ftp, robot, jsapi, webdesktopapi, sftp, dav, desktop, restapi, scim, office, mobile

query_user_id string? - Return results that are actions performed by the user indiciated by this User ID

query_file_id string? - Return results that are file actions related to the file indicated by this File ID

query_parent_id string? - Return results that are file actions inside the parent folder specified by this folder ID

query_path string? - Return results that are file actions related to this path.

query_folder string? - Return results that are file actions related to files or folders inside this folder path.

query_src string? - Return results that are file moves originating from this path.

query_destination string? - Return results that are file moves with this path as destination.

query_ip string? - Filter results by this IP address.

query_username string? - Filter results by this username.

query_failure_type string? - If searching for Histories about login failures, this parameter restricts results to failures of this specific type. Valid values: expired_trial, account_overdue, locked_out, ip_mismatch, password_mismatch, site_mismatch, username_not_found, none, no_ftp_permission, no_web_permission, no_directory, errno_enoent, no_sftp_permission, no_dav_permission, no_restapi_permission, key_mismatch, region_mismatch, expired_access, desktop_ip_mismatch, desktop_api_key_not_used_quickly_enough, disabled, country_mismatch

query_target_id string? - If searching for Histories about specific objects (such as Users, or API Keys), this paremeter restricts results to objects that match this ID.

query_target_name string? - If searching for Histories about Users, Groups or other objects with names, this parameter restricts results to objects with this name/username.

query_target_permission string? - If searching for Histories about Permisisons, this parameter restricts results to permissions of this level.

query_target_user_id string? - If searching for Histories about API keys, this parameter restricts results to API keys created by/for this user ID.

query_target_username string? - If searching for Histories about API keys, this parameter restricts results to API keys created by/for this username.

query_target_platform string? - If searching for Histories about API keys, this parameter restricts results to API keys associated with this platform.

query_target_permission_set string? - If searching for Histories about API keys, this parameter restricts results to API keys with this permission set.

files.com: HistoryExportsBody2

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

start_at string? - Start date/time of export range.

end_at string? - End date/time of export range.

query_action string? - Filter results by this this action type. Valid values: create, read, update, destroy, move, login, failedlogin, copy, user_create, user_update, user_destroy, group_create, group_update, group_destroy, permission_create, permission_destroy, api_key_create, api_key_update, api_key_destroy

query_interface string? - Filter results by this this interface type. Valid values: web, ftp, robot, jsapi, webdesktopapi, sftp, dav, desktop, restapi, scim, office, mobile

query_user_id string? - Return results that are actions performed by the user indiciated by this User ID

query_file_id string? - Return results that are file actions related to the file indicated by this File ID

query_parent_id string? - Return results that are file actions inside the parent folder specified by this folder ID

query_path string? - Return results that are file actions related to this path.

query_folder string? - Return results that are file actions related to files or folders inside this folder path.

query_src string? - Return results that are file moves originating from this path.

query_destination string? - Return results that are file moves with this path as destination.

query_ip string? - Filter results by this IP address.

query_username string? - Filter results by this username.

query_failure_type string? - If searching for Histories about login failures, this parameter restricts results to failures of this specific type. Valid values: expired_trial, account_overdue, locked_out, ip_mismatch, password_mismatch, site_mismatch, username_not_found, none, no_ftp_permission, no_web_permission, no_directory, errno_enoent, no_sftp_permission, no_dav_permission, no_restapi_permission, key_mismatch, region_mismatch, expired_access, desktop_ip_mismatch, desktop_api_key_not_used_quickly_enough, disabled, country_mismatch

query_target_id string? - If searching for Histories about specific objects (such as Users, or API Keys), this paremeter restricts results to objects that match this ID.

query_target_name string? - If searching for Histories about Users, Groups or other objects with names, this parameter restricts results to objects with this name/username.

query_target_permission string? - If searching for Histories about Permisisons, this parameter restricts results to permissions of this level.

query_target_user_id string? - If searching for Histories about API keys, this parameter restricts results to API keys created by/for this user ID.

query_target_username string? - If searching for Histories about API keys, this parameter restricts results to API keys created by/for this username.

query_target_platform string? - If searching for Histories about API keys, this parameter restricts results to API keys associated with this platform.

query_target_permission_set string? - If searching for Histories about API keys, this parameter restricts results to API keys with this permission set.

files.com: IdShareBody

Fields

to string[]? - A list of email addresses to share this bundle with. Required unless recipients is used.

note string? - Note to include in email.

recipients record {}[]? - A list of recipients to share this bundle with. Required unless to is used.

files.com: IdShareBody1

Fields

to string[]? - A list of email addresses to share this bundle with. Required unless recipients is used.

note string? - Note to include in email.

recipients record {}[]? - A list of recipients to share this bundle with. Required unless to is used.

files.com: IdShareBody2

Fields

to string[]? - A list of email addresses to share this bundle with. Required unless recipients is used.

note string? - Note to include in email.

recipients record {}[]? - A list of recipients to share this bundle with. Required unless to is used.

files.com: ImageEntity

Image entity

Fields

name string? - Image name

uri string? - Image URI

files.com: InboxRecipientEntity

List Inbox Recipients

Fields

company string? - The recipient's company.

name string? - The recipient's name.

note string? - A note sent to the recipient with the inbox.

recipient string? - The recipient's email address.

sent_at string? - When the Inbox was shared with this recipient.

files.com: InboxRecipientsBody

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

inbox_id int - Inbox to share.

recipient string - Email address to share this inbox with.

name string? - Name of recipient.

company string? - Company of recipient.

note string? - Note to include in email.

share_after_create boolean? - Set to true to share the link with the recipient upon creation.

files.com: InboxRecipientsBody1

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

inbox_id int - Inbox to share.

recipient string - Email address to share this inbox with.

name string? - Name of recipient.

company string? - Company of recipient.

note string? - Note to include in email.

share_after_create boolean? - Set to true to share the link with the recipient upon creation.

files.com: InboxRecipientsBody2

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

inbox_id int - Inbox to share.

recipient string - Email address to share this inbox with.

name string? - Name of recipient.

company string? - Company of recipient.

note string? - Note to include in email.

share_after_create boolean? - Set to true to share the link with the recipient upon creation.

files.com: InboxRegistrationEntity

List Inbox Registrations

Fields

code string? - Registration cookie code

name string? - Registrant name

company string? - Registrant company name

email string? - Registrant email address

clickwrap_body string? - Clickwrap text that was shown to the registrant

form_field_set_id int? - Id of associated form field set

form_field_data string? - Data for form field set with form field ids as keys and user data as values

files.com: InboxUploadEntity

List Inbox Uploads

Fields

inbox_registration InboxRegistrationEntity? - List Inbox Registrations

path string? - Upload path

created_at string? - Upload date/time

files.com: InvoiceLineItemEntity

Associated invoice line items

Fields

amount decimal? - Invoice line item amount

created_at string? - Invoice line item created at date/time

description string? - Invoice line item description

'type string? - Invoice line item type

service_end_at string? - Invoice line item service end date/time

service_start_at string? - Invoice line item service start date/time

updated_at string? - Invoice line item updated date/time

plan string? - Plan name

site string? - Site name

files.com: IpAddressEntity

List IP Addresses associated with the current site

Fields

id string? - Unique label for list; used by Zapier and other integrations.

associated_with string? - The object that this public IP address list is associated with.

group_id int? - Group ID

ip_addresses string[]? - A list of IP addresses.

files.com: LockEntity

List Locks by path

Fields

path string? - Path

timeout int? - Lock timeout in seconds

depth string? - DEPRECATED: Lock depth

recursive boolean? - Does lock apply to subfolders?

owner string? - Owner of the lock. This can be any arbitrary string.

scope string? - DEPRECATED: Lock scope

exclusive boolean? - Is lock exclusive?

token string? - Lock token. Use to release lock.

'type string? - DEPRECATED: Lock type

allow_access_by_any_user boolean? - Can lock be modified by users other than its creator?

user_id int? - Lock creator user ID

username string? - Lock creator username

files.com: LocksLockpathBody

Fields

allow_access_by_any_user boolean? - Allow lock to be updated by any user?

exclusive boolean? - Is lock exclusive?

recursive string? - Does lock apply to subfolders?

timeout int? - Lock timeout length

files.com: LocksLockpathBody1

Fields

allow_access_by_any_user boolean? - Allow lock to be updated by any user?

exclusive boolean? - Is lock exclusive?

recursive string? - Does lock apply to subfolders?

timeout int? - Lock timeout length

files.com: LocksLockpathBody2

Fields

allow_access_by_any_user boolean? - Allow lock to be updated by any user?

exclusive boolean? - Is lock exclusive?

recursive string? - Does lock apply to subfolders?

timeout int? - Lock timeout length

files.com: MembershipsUserIdBody

Fields

admin boolean? - Is the user a group administrator?

files.com: MembershipsUserIdBody1

Fields

admin boolean? - Is the user a group administrator?

files.com: MembershipsUserIdBody2

Fields

admin boolean? - Is the user a group administrator?

files.com: MessageCommentEntity

List Message Comments

Fields

id int? - Message Comment ID

body string? - Comment body.

reactions MessageCommentReactionEntity? - List Message Comment Reactions

files.com: MessageCommentReactionEntity

List Message Comment Reactions

Fields

id int? - Reaction ID

emoji string? - Emoji used in the reaction.

files.com: MessageCommentReactionsBody

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

emoji string - Emoji to react with.

files.com: MessageCommentReactionsBody1

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

emoji string - Emoji to react with.

files.com: MessageCommentReactionsBody2

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

emoji string - Emoji to react with.

files.com: MessageCommentsBody

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

body string - Comment body.

files.com: MessageCommentsBody1

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

body string - Comment body.

files.com: MessageCommentsBody2

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

body string - Comment body.

files.com: MessageCommentsIdBody

Fields

body string - Comment body.

files.com: MessageCommentsIdBody1

Fields

body string - Comment body.

files.com: MessageCommentsIdBody2

Fields

body string - Comment body.

files.com: MessageEntity

List Messages

Fields

id int? - Message ID

subject string? - Message subject.

body string? - Message body.

comments MessageCommentEntity? - List Message Comments

files.com: MessageReactionEntity

List Message Reactions

Fields

id int? - Reaction ID

emoji string? - Emoji used in the reaction.

files.com: MessageReactionsBody

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

emoji string - Emoji to react with.

files.com: MessageReactionsBody1

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

emoji string - Emoji to react with.

files.com: MessageReactionsBody2

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

emoji string - Emoji to react with.

files.com: MessagesBody

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

project_id int - Project to which the message should be attached.

subject string - Message subject.

body string - Message body.

files.com: MessagesBody1

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

project_id int - Project to which the message should be attached.

subject string - Message subject.

body string - Message body.

files.com: MessagesBody2

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

project_id int - Project to which the message should be attached.

subject string - Message subject.

body string - Message body.

files.com: MessagesIdBody

Fields

project_id int - Project to which the message should be attached.

subject string - Message subject.

body string - Message body.

files.com: MessagesIdBody1

Fields

project_id int - Project to which the message should be attached.

subject string - Message subject.

body string - Message body.

files.com: MessagesIdBody2

Fields

project_id int - Project to which the message should be attached.

subject string - Message subject.

body string - Message body.

files.com: MoveFilepathBody

Fields

destination string - Move destination path.

files.com: MoveFilepathBody1

Fields

destination string - Move destination path.

files.com: MoveFilepathBody2

Fields

destination string - Move destination path.

files.com: NotificationEntity

List Notifications

Fields

id int? - Notification ID

path string? - Folder path to notify on

group_id int? - Notification group id

group_name string? - Group name if applicable

notify_user_actions boolean? - Trigger notification on notification user actions?

notify_on_copy boolean? - Triggers notification when moving or copying files to this path

recursive boolean? - Enable notifications for each subfolder in this path

send_interval string? - The time interval that notifications are aggregated to

unsubscribed boolean? - Is the user unsubscribed from this notification?

unsubscribed_reason string? - The reason that the user unsubscribed

user_id int? - Notification user ID

username string? - Notification username

suppressed_email boolean? - If true, it means that the recipient at this user's email address has manually unsubscribed from all emails, or had their email "hard bounce", which means that we are unable to send mail to this user's current email address. Notifications will resume if the user changes their email address.

files.com: NotificationsBody

Fields

user_id int? - The id of the user to notify. Provide user_id, username or group_id.

notify_on_copy boolean? - If true, copying or moving resources into this path will trigger a notification, in addition to just uploads.

notify_user_actions boolean? - If true actions initiated by the user will still result in a notification

recursive boolean? - If true, enable notifications for each subfolder in this path

send_interval string? - The time interval that notifications are aggregated by. Can be five_minutes, fifteen_minutes, hourly, or daily.

group_id int? - The ID of the group to notify. Provide user_id, username or group_id.

path string? - Path

username string? - The username of the user to notify. Provide user_id, username or group_id.

files.com: NotificationsBody1

Fields

user_id int? - The id of the user to notify. Provide user_id, username or group_id.

notify_on_copy boolean? - If true, copying or moving resources into this path will trigger a notification, in addition to just uploads.

notify_user_actions boolean? - If true actions initiated by the user will still result in a notification

recursive boolean? - If true, enable notifications for each subfolder in this path

send_interval string? - The time interval that notifications are aggregated by. Can be five_minutes, fifteen_minutes, hourly, or daily.

group_id int? - The ID of the group to notify. Provide user_id, username or group_id.

path string? - Path

username string? - The username of the user to notify. Provide user_id, username or group_id.

files.com: NotificationsBody2

Fields

user_id int? - The id of the user to notify. Provide user_id, username or group_id.

notify_on_copy boolean? - If true, copying or moving resources into this path will trigger a notification, in addition to just uploads.

notify_user_actions boolean? - If true actions initiated by the user will still result in a notification

recursive boolean? - If true, enable notifications for each subfolder in this path

send_interval string? - The time interval that notifications are aggregated by. Can be five_minutes, fifteen_minutes, hourly, or daily.

group_id int? - The ID of the group to notify. Provide user_id, username or group_id.

path string? - Path

username string? - The username of the user to notify. Provide user_id, username or group_id.

files.com: NotificationsIdBody

Fields

notify_on_copy boolean? - If true, copying or moving resources into this path will trigger a notification, in addition to just uploads.

notify_user_actions boolean? - If true actions initiated by the user will still result in a notification

recursive boolean? - If true, enable notifications for each subfolder in this path

send_interval string? - The time interval that notifications are aggregated by. Can be five_minutes, fifteen_minutes, hourly, or daily.

files.com: NotificationsIdBody1

Fields

notify_on_copy boolean? - If true, copying or moving resources into this path will trigger a notification, in addition to just uploads.

notify_user_actions boolean? - If true actions initiated by the user will still result in a notification

recursive boolean? - If true, enable notifications for each subfolder in this path

send_interval string? - The time interval that notifications are aggregated by. Can be five_minutes, fifteen_minutes, hourly, or daily.

files.com: NotificationsIdBody2

Fields

notify_on_copy boolean? - If true, copying or moving resources into this path will trigger a notification, in addition to just uploads.

notify_user_actions boolean? - If true actions initiated by the user will still result in a notification

recursive boolean? - If true, enable notifications for each subfolder in this path

send_interval string? - The time interval that notifications are aggregated by. Can be five_minutes, fifteen_minutes, hourly, or daily.

files.com: PatchFormFieldSets

Update Form Field Set

Fields

title string? - Title to be displayed

skip_email boolean? - Skip validating form email

skip_name boolean? - Skip validating form name

skip_company boolean? - Skip validating company

form_fields PatchformfieldsetsFormFields[]? - Form fields

files.com: PatchformfieldsetsFormFields

Fields

id int? - Id of existing Form Field

label string? - Label of Field

field_type string? - Type of field: text, text_area, dropdown, or radio

help_text string? - Help text of field

required boolean? - Is this a required field? (default true)

options_for_select string? - List of options for dropdown or radio

default_option string? - Default option to be preselected in the dropdown or radio.

files.com: PaymentLineItemEntity

Associated payment line items

Fields

amount decimal? - Payment line item amount

created_at string? - Payment line item created at date/time

invoice_id int? - Invoice ID

payment_id int? - Payment ID

updated_at string? - Payment line item updated at date/time

files.com: PermissionEntity

List Permissions

Fields

id int? - Permission ID

path string? - Folder path

user_id int? - User ID

username string? - User's username

group_id int? - Group ID

group_name string? - Group name if applicable

permission string? - Permission type

recursive boolean? - Does this permission apply to subfolders?

files.com: PermissionsBody

Fields

group_id int? - Group ID

path string? - Folder path

permission string? - Permission type. Can be admin, full, readonly, writeonly, list, or history

recursive boolean? - Apply to subfolders recursively?

user_id int? - User ID. Provide username or user_id

username string? - User username. Provide username or user_id

files.com: PermissionsBody1

Fields

group_id int? - Group ID

path string? - Folder path

permission string? - Permission type. Can be admin, full, readonly, writeonly, list, or history

recursive boolean? - Apply to subfolders recursively?

user_id int? - User ID. Provide username or user_id

username string? - User username. Provide username or user_id

files.com: PermissionsBody2

Fields

group_id int? - Group ID

path string? - Folder path

permission string? - Permission type. Can be admin, full, readonly, writeonly, list, or history

recursive boolean? - Apply to subfolders recursively?

user_id int? - User ID. Provide username or user_id

username string? - User username. Provide username or user_id

files.com: PostFormFieldSets

Create Form Field Set

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

title string? - Title to be displayed

skip_email boolean? - Skip validating form email

skip_name boolean? - Skip validating form name

skip_company boolean? - Skip validating company

form_fields PatchformfieldsetsFormFields[]? - Form fields

files.com: PreviewEntity

File preview

Fields

id int? - Preview ID

status string? - Preview status. Can be invalid, not_generated, generating, complete, or file_too_large

download_uri string? - Link to download preview

'type string? - Preview status. Can be invalid, not_generated, generating, complete, or file_too_large

size int? - Preview size

files.com: ProjectEntity

List Projects

Fields

id int? - Project ID

global_access string? - Global access settings

files.com: ProjectsBody

Fields

global_access string - Global permissions. Can be: none, anyone_with_read, anyone_with_full.

files.com: ProjectsBody1

Fields

global_access string - Global permissions. Can be: none, anyone_with_read, anyone_with_full.

files.com: ProjectsBody2

Fields

global_access string - Global permissions. Can be: none, anyone_with_read, anyone_with_full.

files.com: ProjectsIdBody

Fields

global_access string - Global permissions. Can be: none, anyone_with_read, anyone_with_full.

files.com: ProjectsIdBody1

Fields

global_access string - Global permissions. Can be: none, anyone_with_read, anyone_with_full.

files.com: ProjectsIdBody2

Fields

global_access string - Global permissions. Can be: none, anyone_with_read, anyone_with_full.

files.com: 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

files.com: PublicIpAddressEntity

List all possible public IP addresses

Fields

ip_address string? - The public IP address.

server_name string? - The name of the frontend server.

files.com: PublicKeyEntity

List Public Keys

Fields

id int? - Public key ID

title string? - Public key title

created_at string? - Public key created at date/time

fingerprint string? - Public key fingerprint

files.com: PublicKeysBody

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

title string - Internal reference for key.

public_key string - Actual contents of SSH key.

files.com: PublicKeysBody1

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

title string - Internal reference for key.

public_key string - Actual contents of SSH key.

files.com: PublicKeysBody2

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

title string - Internal reference for key.

public_key string - Actual contents of SSH key.

files.com: PublicKeysIdBody

Fields

title string - Internal reference for key.

files.com: PublicKeysIdBody1

Fields

title string - Internal reference for key.

files.com: PublicKeysIdBody2

Fields

title string - Internal reference for key.

files.com: RemoteServerEntity

Create Remote Server

Fields

id int? - Remote server ID

authentication_method string? - Type of authentication method

hostname string? - Hostname or IP address

remote_home_path string? - Initial home folder on remote server

name string? - Internal name for your reference

port int? - Port for remote server. Not needed for S3.

max_connections int? - Max number of parallel connections. Ignored for S3 connections (we will parallelize these as much as possible).

s3_bucket string? - S3 bucket name

s3_region string? - S3 region

server_certificate string? - Remote server certificate

server_host_key string? - Remote server SSH Host Key. If provided, we will require that the server host key matches the provided key. Uses OpenSSH format similar to what would go into ~/.ssh/known_hosts

server_type string? - Remote server type.

ssl string? - Should we require SSL?

username string? - Remote server username. Not needed for S3 buckets.

google_cloud_storage_bucket string? - Google Cloud Storage bucket name

google_cloud_storage_project_id string? - Google Cloud Project ID

backblaze_b2_s3_endpoint string? - Backblaze B2 Cloud Storage S3 Endpoint

backblaze_b2_bucket string? - Backblaze B2 Cloud Storage Bucket name

wasabi_bucket string? - Wasabi Bucket name

wasabi_region string? - Wasabi region

rackspace_username string? - Rackspace username used to login to the Rackspace Cloud Control Panel.

rackspace_region string? - Three letter airport code for Rackspace region. See https://support.rackspace.com/how-to/about-regions/

rackspace_container string? - The name of the container (top level directory) where files will sync.

auth_setup_link string? - Returns link to login with an Oauth provider

auth_status string? - Either in_setup or complete

auth_account_name string? - Describes the authorized account

one_drive_account_type string? - Either personal or business_other account types

azure_blob_storage_account string? - Azure Blob Storage Account name

azure_blob_storage_container string? - Azure Blob Storage Container name

s3_compatible_bucket string? - S3-compatible Bucket name

s3_compatible_region string? - S3-compatible Bucket name

s3_compatible_endpoint string? - S3-compatible endpoint

enable_dedicated_ips boolean? - true if remote server only accepts connections from dedicated IPs

files.com: RemoteServersBody

Fields

aws_access_key string? - AWS Access Key.

aws_secret_key string? - AWS secret key.

password string? - Password if needed.

private_key string? - Private key if needed.

ssl_certificate string? - SSL client certificate.

google_cloud_storage_credentials_json string? - A JSON file that contains the private key. To generate see https://cloud.google.com/storage/docs/json_api/v1/how-tos/authorizing#APIKey

wasabi_access_key string? - Wasabi access key.

wasabi_secret_key string? - Wasabi secret key.

backblaze_b2_key_id string? - Backblaze B2 Cloud Storage keyID.

backblaze_b2_application_key string? - Backblaze B2 Cloud Storage applicationKey.

rackspace_api_key string? - Rackspace API key from the Rackspace Cloud Control Panel.

reset_authentication boolean? - Reset authenticated account

azure_blob_storage_access_key string? - Azure Blob Storage secret key.

hostname string? - Hostname or IP address

name string? - Internal name for your reference

max_connections int? - Max number of parallel connections. Ignored for S3 connections (we will parallelize these as much as possible).

port int? - Port for remote server. Not needed for S3.

s3_bucket string? - S3 bucket name

s3_region string? - S3 region

server_certificate string? - Remote server certificate

server_host_key string? - Remote server SSH Host Key. If provided, we will require that the server host key matches the provided key. Uses OpenSSH format similar to what would go into ~/.ssh/known_hosts

server_type string? - Remote server type.

ssl string? - Should we require SSL?

username string? - Remote server username. Not needed for S3 buckets.

google_cloud_storage_bucket string? - Google Cloud Storage bucket name

google_cloud_storage_project_id string? - Google Cloud Project ID

backblaze_b2_bucket string? - Backblaze B2 Cloud Storage Bucket name

backblaze_b2_s3_endpoint string? - Backblaze B2 Cloud Storage S3 Endpoint

wasabi_bucket string? - Wasabi Bucket name

wasabi_region string? - Wasabi region

rackspace_username string? - Rackspace username used to login to the Rackspace Cloud Control Panel.

rackspace_region string? - Three letter airport code for Rackspace region. See https://support.rackspace.com/how-to/about-regions/

rackspace_container string? - The name of the container (top level directory) where files will sync.

one_drive_account_type string? - Either personal or business_other account types

azure_blob_storage_account string? - Azure Blob Storage Account name

azure_blob_storage_container string? - Azure Blob Storage Container name

s3_compatible_bucket string? - S3-compatible Bucket name

s3_compatible_region string? - S3-compatible Bucket name

s3_compatible_endpoint string? - S3-compatible endpoint

enable_dedicated_ips boolean? - true if remote server only accepts connections from dedicated IPs

s3_compatible_access_key string? - S3-compatible access key

s3_compatible_secret_key string? - S3-compatible secret key

files.com: RemoteServersBody1

Fields

aws_access_key string? - AWS Access Key.

aws_secret_key string? - AWS secret key.

password string? - Password if needed.

private_key string? - Private key if needed.

ssl_certificate string? - SSL client certificate.

google_cloud_storage_credentials_json string? - A JSON file that contains the private key. To generate see https://cloud.google.com/storage/docs/json_api/v1/how-tos/authorizing#APIKey

wasabi_access_key string? - Wasabi access key.

wasabi_secret_key string? - Wasabi secret key.

backblaze_b2_key_id string? - Backblaze B2 Cloud Storage keyID.

backblaze_b2_application_key string? - Backblaze B2 Cloud Storage applicationKey.

rackspace_api_key string? - Rackspace API key from the Rackspace Cloud Control Panel.

reset_authentication boolean? - Reset authenticated account

azure_blob_storage_access_key string? - Azure Blob Storage secret key.

hostname string? - Hostname or IP address

name string? - Internal name for your reference

max_connections int? - Max number of parallel connections. Ignored for S3 connections (we will parallelize these as much as possible).

port int? - Port for remote server. Not needed for S3.

s3_bucket string? - S3 bucket name

s3_region string? - S3 region

server_certificate string? - Remote server certificate

server_host_key string? - Remote server SSH Host Key. If provided, we will require that the server host key matches the provided key. Uses OpenSSH format similar to what would go into ~/.ssh/known_hosts

server_type string? - Remote server type.

ssl string? - Should we require SSL?

username string? - Remote server username. Not needed for S3 buckets.

google_cloud_storage_bucket string? - Google Cloud Storage bucket name

google_cloud_storage_project_id string? - Google Cloud Project ID

backblaze_b2_bucket string? - Backblaze B2 Cloud Storage Bucket name

backblaze_b2_s3_endpoint string? - Backblaze B2 Cloud Storage S3 Endpoint

wasabi_bucket string? - Wasabi Bucket name

wasabi_region string? - Wasabi region

rackspace_username string? - Rackspace username used to login to the Rackspace Cloud Control Panel.

rackspace_region string? - Three letter airport code for Rackspace region. See https://support.rackspace.com/how-to/about-regions/

rackspace_container string? - The name of the container (top level directory) where files will sync.

one_drive_account_type string? - Either personal or business_other account types

azure_blob_storage_account string? - Azure Blob Storage Account name

azure_blob_storage_container string? - Azure Blob Storage Container name

s3_compatible_bucket string? - S3-compatible Bucket name

s3_compatible_region string? - S3-compatible Bucket name

s3_compatible_endpoint string? - S3-compatible endpoint

enable_dedicated_ips boolean? - true if remote server only accepts connections from dedicated IPs

s3_compatible_access_key string? - S3-compatible access key

s3_compatible_secret_key string? - S3-compatible secret key

files.com: RemoteServersBody2

Fields

aws_access_key string? - AWS Access Key.

aws_secret_key string? - AWS secret key.

password string? - Password if needed.

private_key string? - Private key if needed.

ssl_certificate string? - SSL client certificate.

google_cloud_storage_credentials_json string? - A JSON file that contains the private key. To generate see https://cloud.google.com/storage/docs/json_api/v1/how-tos/authorizing#APIKey

wasabi_access_key string? - Wasabi access key.

wasabi_secret_key string? - Wasabi secret key.

backblaze_b2_key_id string? - Backblaze B2 Cloud Storage keyID.

backblaze_b2_application_key string? - Backblaze B2 Cloud Storage applicationKey.

rackspace_api_key string? - Rackspace API key from the Rackspace Cloud Control Panel.

reset_authentication boolean? - Reset authenticated account

azure_blob_storage_access_key string? - Azure Blob Storage secret key.

hostname string? - Hostname or IP address

name string? - Internal name for your reference

max_connections int? - Max number of parallel connections. Ignored for S3 connections (we will parallelize these as much as possible).

port int? - Port for remote server. Not needed for S3.

s3_bucket string? - S3 bucket name

s3_region string? - S3 region

server_certificate string? - Remote server certificate

server_host_key string? - Remote server SSH Host Key. If provided, we will require that the server host key matches the provided key. Uses OpenSSH format similar to what would go into ~/.ssh/known_hosts

server_type string? - Remote server type.

ssl string? - Should we require SSL?

username string? - Remote server username. Not needed for S3 buckets.

google_cloud_storage_bucket string? - Google Cloud Storage bucket name

google_cloud_storage_project_id string? - Google Cloud Project ID

backblaze_b2_bucket string? - Backblaze B2 Cloud Storage Bucket name

backblaze_b2_s3_endpoint string? - Backblaze B2 Cloud Storage S3 Endpoint

wasabi_bucket string? - Wasabi Bucket name

wasabi_region string? - Wasabi region

rackspace_username string? - Rackspace username used to login to the Rackspace Cloud Control Panel.

rackspace_region string? - Three letter airport code for Rackspace region. See https://support.rackspace.com/how-to/about-regions/

rackspace_container string? - The name of the container (top level directory) where files will sync.

one_drive_account_type string? - Either personal or business_other account types

azure_blob_storage_account string? - Azure Blob Storage Account name

azure_blob_storage_container string? - Azure Blob Storage Container name

s3_compatible_bucket string? - S3-compatible Bucket name

s3_compatible_region string? - S3-compatible Bucket name

s3_compatible_endpoint string? - S3-compatible endpoint

enable_dedicated_ips boolean? - true if remote server only accepts connections from dedicated IPs

s3_compatible_access_key string? - S3-compatible access key

s3_compatible_secret_key string? - S3-compatible secret key

files.com: RemoteServersIdBody

Fields

aws_access_key string? - AWS Access Key.

aws_secret_key string? - AWS secret key.

password string? - Password if needed.

private_key string? - Private key if needed.

ssl_certificate string? - SSL client certificate.

google_cloud_storage_credentials_json string? - A JSON file that contains the private key. To generate see https://cloud.google.com/storage/docs/json_api/v1/how-tos/authorizing#APIKey

wasabi_access_key string? - Wasabi access key.

wasabi_secret_key string? - Wasabi secret key.

backblaze_b2_key_id string? - Backblaze B2 Cloud Storage keyID.

backblaze_b2_application_key string? - Backblaze B2 Cloud Storage applicationKey.

rackspace_api_key string? - Rackspace API key from the Rackspace Cloud Control Panel.

reset_authentication boolean? - Reset authenticated account

azure_blob_storage_access_key string? - Azure Blob Storage secret key.

hostname string? - Hostname or IP address

name string? - Internal name for your reference

max_connections int? - Max number of parallel connections. Ignored for S3 connections (we will parallelize these as much as possible).

port int? - Port for remote server. Not needed for S3.

s3_bucket string? - S3 bucket name

s3_region string? - S3 region

server_certificate string? - Remote server certificate

server_host_key string? - Remote server SSH Host Key. If provided, we will require that the server host key matches the provided key. Uses OpenSSH format similar to what would go into ~/.ssh/known_hosts

server_type string? - Remote server type.

ssl string? - Should we require SSL?

username string? - Remote server username. Not needed for S3 buckets.

google_cloud_storage_bucket string? - Google Cloud Storage bucket name

google_cloud_storage_project_id string? - Google Cloud Project ID

backblaze_b2_bucket string? - Backblaze B2 Cloud Storage Bucket name

backblaze_b2_s3_endpoint string? - Backblaze B2 Cloud Storage S3 Endpoint

wasabi_bucket string? - Wasabi Bucket name

wasabi_region string? - Wasabi region

rackspace_username string? - Rackspace username used to login to the Rackspace Cloud Control Panel.

rackspace_region string? - Three letter airport code for Rackspace region. See https://support.rackspace.com/how-to/about-regions/

rackspace_container string? - The name of the container (top level directory) where files will sync.

one_drive_account_type string? - Either personal or business_other account types

azure_blob_storage_account string? - Azure Blob Storage Account name

azure_blob_storage_container string? - Azure Blob Storage Container name

s3_compatible_bucket string? - S3-compatible Bucket name

s3_compatible_region string? - S3-compatible Bucket name

s3_compatible_endpoint string? - S3-compatible endpoint

enable_dedicated_ips boolean? - true if remote server only accepts connections from dedicated IPs

s3_compatible_access_key string? - S3-compatible access key

s3_compatible_secret_key string? - S3-compatible secret key

files.com: RemoteServersIdBody1

Fields

aws_access_key string? - AWS Access Key.

aws_secret_key string? - AWS secret key.

password string? - Password if needed.

private_key string? - Private key if needed.

ssl_certificate string? - SSL client certificate.

google_cloud_storage_credentials_json string? - A JSON file that contains the private key. To generate see https://cloud.google.com/storage/docs/json_api/v1/how-tos/authorizing#APIKey

wasabi_access_key string? - Wasabi access key.

wasabi_secret_key string? - Wasabi secret key.

backblaze_b2_key_id string? - Backblaze B2 Cloud Storage keyID.

backblaze_b2_application_key string? - Backblaze B2 Cloud Storage applicationKey.

rackspace_api_key string? - Rackspace API key from the Rackspace Cloud Control Panel.

reset_authentication boolean? - Reset authenticated account

azure_blob_storage_access_key string? - Azure Blob Storage secret key.

hostname string? - Hostname or IP address

name string? - Internal name for your reference

max_connections int? - Max number of parallel connections. Ignored for S3 connections (we will parallelize these as much as possible).

port int? - Port for remote server. Not needed for S3.

s3_bucket string? - S3 bucket name

s3_region string? - S3 region

server_certificate string? - Remote server certificate

server_host_key string? - Remote server SSH Host Key. If provided, we will require that the server host key matches the provided key. Uses OpenSSH format similar to what would go into ~/.ssh/known_hosts

server_type string? - Remote server type.

ssl string? - Should we require SSL?

username string? - Remote server username. Not needed for S3 buckets.

google_cloud_storage_bucket string? - Google Cloud Storage bucket name

google_cloud_storage_project_id string? - Google Cloud Project ID

backblaze_b2_bucket string? - Backblaze B2 Cloud Storage Bucket name

backblaze_b2_s3_endpoint string? - Backblaze B2 Cloud Storage S3 Endpoint

wasabi_bucket string? - Wasabi Bucket name

wasabi_region string? - Wasabi region

rackspace_username string? - Rackspace username used to login to the Rackspace Cloud Control Panel.

rackspace_region string? - Three letter airport code for Rackspace region. See https://support.rackspace.com/how-to/about-regions/

rackspace_container string? - The name of the container (top level directory) where files will sync.

one_drive_account_type string? - Either personal or business_other account types

azure_blob_storage_account string? - Azure Blob Storage Account name

azure_blob_storage_container string? - Azure Blob Storage Container name

s3_compatible_bucket string? - S3-compatible Bucket name

s3_compatible_region string? - S3-compatible Bucket name

s3_compatible_endpoint string? - S3-compatible endpoint

enable_dedicated_ips boolean? - true if remote server only accepts connections from dedicated IPs

s3_compatible_access_key string? - S3-compatible access key

s3_compatible_secret_key string? - S3-compatible secret key

files.com: RemoteServersIdBody2

Fields

aws_access_key string? - AWS Access Key.

aws_secret_key string? - AWS secret key.

password string? - Password if needed.

private_key string? - Private key if needed.

ssl_certificate string? - SSL client certificate.

google_cloud_storage_credentials_json string? - A JSON file that contains the private key. To generate see https://cloud.google.com/storage/docs/json_api/v1/how-tos/authorizing#APIKey

wasabi_access_key string? - Wasabi access key.

wasabi_secret_key string? - Wasabi secret key.

backblaze_b2_key_id string? - Backblaze B2 Cloud Storage keyID.

backblaze_b2_application_key string? - Backblaze B2 Cloud Storage applicationKey.

rackspace_api_key string? - Rackspace API key from the Rackspace Cloud Control Panel.

reset_authentication boolean? - Reset authenticated account

azure_blob_storage_access_key string? - Azure Blob Storage secret key.

hostname string? - Hostname or IP address

name string? - Internal name for your reference

max_connections int? - Max number of parallel connections. Ignored for S3 connections (we will parallelize these as much as possible).

port int? - Port for remote server. Not needed for S3.

s3_bucket string? - S3 bucket name

s3_region string? - S3 region

server_certificate string? - Remote server certificate

server_host_key string? - Remote server SSH Host Key. If provided, we will require that the server host key matches the provided key. Uses OpenSSH format similar to what would go into ~/.ssh/known_hosts

server_type string? - Remote server type.

ssl string? - Should we require SSL?

username string? - Remote server username. Not needed for S3 buckets.

google_cloud_storage_bucket string? - Google Cloud Storage bucket name

google_cloud_storage_project_id string? - Google Cloud Project ID

backblaze_b2_bucket string? - Backblaze B2 Cloud Storage Bucket name

backblaze_b2_s3_endpoint string? - Backblaze B2 Cloud Storage S3 Endpoint

wasabi_bucket string? - Wasabi Bucket name

wasabi_region string? - Wasabi region

rackspace_username string? - Rackspace username used to login to the Rackspace Cloud Control Panel.

rackspace_region string? - Three letter airport code for Rackspace region. See https://support.rackspace.com/how-to/about-regions/

rackspace_container string? - The name of the container (top level directory) where files will sync.

one_drive_account_type string? - Either personal or business_other account types

azure_blob_storage_account string? - Azure Blob Storage Account name

azure_blob_storage_container string? - Azure Blob Storage Container name

s3_compatible_bucket string? - S3-compatible Bucket name

s3_compatible_region string? - S3-compatible Bucket name

s3_compatible_endpoint string? - S3-compatible endpoint

enable_dedicated_ips boolean? - true if remote server only accepts connections from dedicated IPs

s3_compatible_access_key string? - S3-compatible access key

s3_compatible_secret_key string? - S3-compatible secret key

files.com: RequestEntity

List Requests

Fields

id int? - Request ID

path string? - Folder path

'source string? - Source filename, if applicable

destination string? - Destination filename

automation_id string? - ID of automation that created request

user_display_name string? - User making the request (if applicable)

files.com: RequestsBody

Fields

path string - Folder path on which to request the file.

destination string - Destination filename (without extension) to request.

user_ids string? - A list of user IDs to request the file from. If sent as a string, it should be comma-delimited.

group_ids string? - A list of group IDs to request the file from. If sent as a string, it should be comma-delimited.

files.com: RequestsBody1

Fields

path string - Folder path on which to request the file.

destination string - Destination filename (without extension) to request.

user_ids string? - A list of user IDs to request the file from. If sent as a string, it should be comma-delimited.

group_ids string? - A list of group IDs to request the file from. If sent as a string, it should be comma-delimited.

files.com: RequestsBody2

Fields

path string - Folder path on which to request the file.

destination string - Destination filename (without extension) to request.

user_ids string? - A list of user IDs to request the file from. If sent as a string, it should be comma-delimited.

group_ids string? - A list of group IDs to request the file from. If sent as a string, it should be comma-delimited.

files.com: SessionEntity

Create user session (log in)

Fields

id string? - Session ID

language string? - Session language

login_token string? - Login token. If set, this token will allow your user to log in via browser at the domain in login_token_domain.

login_token_domain string? - Domain to use with login_token.

max_dir_listing_size int? - Maximum number of files to retrieve per folder for a directory listing. This is based on the user's plan.

multiple_regions boolean? - Can access multiple regions?

read_only boolean? - Is this session read only?

root_path string? - Initial root path to start the user's session in.

site_id int? - Site ID

ssl_required boolean? - Is SSL required for this user? (If so, ensure all your communications with this user use SSL.)

tls_disabled boolean? - Is strong TLS disabled for this user? (If this is set to true, the site administrator has signaled that it is ok to use less secure TLS versions for this user.)

two_factor_setup_needed boolean? - If true, this user needs to add a Two Factor Authentication method before performing any further actions.

allowed_2fa_method_sms boolean? - Sent only if 2FA setup is needed. Is SMS two factor authentication allowed?

allowed_2fa_method_totp boolean? - Sent only if 2FA setup is needed. Is TOTP two factor authentication allowed?

allowed_2fa_method_u2f boolean? - Sent only if 2FA setup is needed. Is U2F two factor authentication allowed?

allowed_2fa_method_yubi boolean? - Sent only if 2FA setup is needed. Is Yubikey two factor authentication allowed?

use_provided_modified_at boolean? - Allow the user to provide file/folder modified at dates? If false, the server will always use the current date/time.

windows_mode_ftp boolean? - Does this user want to use Windows line-ending emulation? (CR vs CRLF)

files.com: SessionsBody

Fields

username string? - Username to sign in as

password string? - Password for sign in

otp string? - If this user has a 2FA device, provide its OTP or code here.

partial_session_id string? - Identifier for a partially-completed login

files.com: SessionsBody1

Fields

username string? - Username to sign in as

password string? - Password for sign in

otp string? - If this user has a 2FA device, provide its OTP or code here.

partial_session_id string? - Identifier for a partially-completed login

files.com: SessionsBody2

Fields

username string? - Username to sign in as

password string? - Password for sign in

otp string? - If this user has a 2FA device, provide its OTP or code here.

partial_session_id string? - Identifier for a partially-completed login

files.com: SettingsChangeEntity

List Settings Changes

Fields

change_details record {}? - Specifics on what changed.

created_at string? - The time this change was made

user_id int? - The user id responsible for this change

files.com: SiteApiKeysBody

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

name string? - Internal name for the API Key. For your use.

expires_at string? - API Key expiration date

permission_set string? - Permissions for this API Key. Keys with the desktop_app permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations). Additional permission sets may become available in the future, such as for a Site Admin to give a key with no administrator privileges. If you have ideas for permission sets, please let us know.

path string? - Folder path restriction for this api key.

files.com: SiteApiKeysBody1

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

name string? - Internal name for the API Key. For your use.

expires_at string? - API Key expiration date

permission_set string? - Permissions for this API Key. Keys with the desktop_app permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations). Additional permission sets may become available in the future, such as for a Site Admin to give a key with no administrator privileges. If you have ideas for permission sets, please let us know.

path string? - Folder path restriction for this api key.

files.com: SiteApiKeysBody2

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

name string? - Internal name for the API Key. For your use.

expires_at string? - API Key expiration date

permission_set string? - Permissions for this API Key. Keys with the desktop_app permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations). Additional permission sets may become available in the future, such as for a Site Admin to give a key with no administrator privileges. If you have ideas for permission sets, please let us know.

path string? - Folder path restriction for this api key.

files.com: SiteBody

Fields

name string? - Site name

subdomain string? - Site subdomain

domain string? - Custom domain

email string? - Main email for this site

reply_to_email string? - Reply-to email for this site

allow_bundle_names boolean? - Are manual Bundle names allowed?

bundle_expiration int? - Site-wide Bundle expiration in days

overage_notify boolean? - Notify site email of overages?

welcome_email_enabled boolean? - Will the welcome email be sent to new users?

ask_about_overwrites boolean? - If false, rename conflicting files instead of asking for overwrite confirmation. Only applies to web interface.

show_request_access_link boolean? - Show request access link for users without access? Currently unused.

welcome_email_cc string? - Include this email in welcome emails if enabled

welcome_custom_text string? - Custom text send in user welcome email

language string? - Site default language

windows_mode_ftp boolean? - Does FTP user Windows emulation mode?

default_time_zone string? - Site default time zone

desktop_app boolean? - Is the desktop app enabled?

desktop_app_session_ip_pinning boolean? - Is desktop app session IP pinning enabled?

desktop_app_session_lifetime int? - Desktop app session lifetime (in hours)

mobile_app boolean? - Is the mobile app enabled?

mobile_app_session_ip_pinning boolean? - Is mobile app session IP pinning enabled?

mobile_app_session_lifetime int? - Mobile app session lifetime (in hours)

folder_permissions_groups_only boolean? - If true, permissions for this site must be bound to a group (not a user). Otherwise, permissions must be bound to a user.

welcome_screen string? - Does the welcome screen appear?

office_integration_available boolean? - Allow users to use Office for the web?

session_expiry decimal? - Session expiry in hours

ssl_required boolean? - Is SSL required? Disabling this is insecure.

tls_disabled boolean? - Is TLS disabled(site setting)?

user_lockout boolean? - Will users be locked out after incorrect login attempts?

user_lockout_tries int? - Number of login tries within user_lockout_within hours before users are locked out

user_lockout_within int? - Number of hours for user lockout window

user_lockout_lock_period int? - How many hours to lock user out for failed password?

include_password_in_welcome_email boolean? - Include password in emails to new users?

allowed_countries string? - Comma seperated list of allowed Country codes

allowed_ips string? - List of allowed IP addresses

disallowed_countries string? - Comma seperated list of disallowed Country codes

days_to_retain_backups int? - Number of days to keep deleted files

max_prior_passwords int? - Number of prior passwords to disallow

password_validity_days int? - Number of days password is valid

password_min_length int? - Shortest password length for users

password_require_letter boolean? - Require a letter in passwords?

password_require_mixed boolean? - Require lower and upper case letters in passwords?

password_require_special boolean? - Require special characters in password?

password_require_number boolean? - Require a number in passwords?

password_require_unbreached boolean? - Require passwords that have not been previously breached? (see https://haveibeenpwned.com/)

sftp_user_root_enabled boolean? - Use user FTP roots also for SFTP?

disable_password_reset boolean? - Is password reset disabled?

immutable_files boolean? - Are files protected from modification?

session_pinned_by_ip boolean? - Are sessions locked to the same IP? (i.e. do users need to log in again if they change IPs?)

bundle_password_required boolean? - Do Bundles require password protection?

bundle_require_share_recipient boolean? - Do Bundles require recipients for sharing?

password_requirements_apply_to_bundles boolean? - Require bundles' passwords, and passwords for other items (inboxes, public shares, etc.) to conform to the same requirements as users' passwords?

opt_out_global boolean? - Use servers in the USA only?

use_provided_modified_at boolean? - Allow uploaders to set provided_modified_at for uploaded files?

custom_namespace boolean? - Is this site using a custom namespace for users?

disable_users_from_inactivity_period_days int? - If greater than zero, users will unable to login if they do not show activity within this number of days.

non_sso_groups_allowed boolean? - If true, groups can be manually created / modified / deleted by Site Admins. Otherwise, groups can only be managed via your SSO provider.

non_sso_users_allowed boolean? - If true, users can be manually created / modified / deleted by Site Admins. Otherwise, users can only be managed via your SSO provider.

sharing_enabled boolean? - Allow bundle creation

user_requests_enabled boolean? - Enable User Requests feature

allowed_2fa_method_sms boolean? - Is SMS two factor authentication allowed?

allowed_2fa_method_u2f boolean? - Is U2F two factor authentication allowed?

allowed_2fa_method_totp boolean? - Is TOTP two factor authentication allowed?

allowed_2fa_method_yubi boolean? - Is yubikey two factor authentication allowed?

require_2fa boolean? - Require two-factor authentication for all users?

require_2fa_user_type string? - What type of user is required to use two-factor authentication (when require_2fa is set to true for this site)?

color2_top string? - Top bar background color

color2_left string? - Page link and button color

color2_link string? - Top bar link color

color2_text string? - Page link and button color

color2_top_text string? - Top bar text color

site_header string? - Custom site header text

site_footer string? - Custom site footer text

login_help_text string? - Login help text

smtp_address string? - SMTP server hostname or IP

smtp_authentication string? - SMTP server authentication type

smtp_from string? - From address to use when mailing through custom SMTP

smtp_username string? - SMTP server username

smtp_port int? - SMTP server port

ldap_enabled boolean? - Main LDAP setting: is LDAP enabled?

ldap_type string? - LDAP type

ldap_host string? - LDAP host

ldap_host_2 string? - LDAP backup host

ldap_host_3 string? - LDAP backup host

ldap_port int? - LDAP port

ldap_secure boolean? - Use secure LDAP?

ldap_username string? - Username for signing in to LDAP server.

ldap_username_field string? - LDAP username field

ldap_domain string? - Domain name that will be appended to usernames

ldap_user_action string? - Should we sync users from LDAP server?

ldap_group_action string? - Should we sync groups from LDAP server?

ldap_user_include_groups string? - Comma or newline separated list of group names (with optional wildcards) - if provided, only users in these groups will be added or synced.

ldap_group_exclusion string? - Comma or newline separated list of group names (with optional wildcards) to exclude when syncing.

ldap_group_inclusion string? - Comma or newline separated list of group names (with optional wildcards) to include when syncing.

ldap_base_dn string? - Base DN for looking up users in LDAP server

icon16_file string? -

icon16_delete boolean? - If true, will delete the file stored in icon16

icon32_file string? -

icon32_delete boolean? - If true, will delete the file stored in icon32

icon48_file string? -

icon48_delete boolean? - If true, will delete the file stored in icon48

icon128_file string? -

icon128_delete boolean? - If true, will delete the file stored in icon128

logo_file string? -

logo_delete boolean? - If true, will delete the file stored in logo

disable_2fa_with_delay boolean? - If set to true, we will begin the process of disabling 2FA on this site.

ldap_password_change string? - New LDAP password.

ldap_password_change_confirmation string? - Confirm new LDAP password.

smtp_password string? - Password for SMTP server.

files.com: SiteBody1

Fields

name string? - Site name

subdomain string? - Site subdomain

domain string? - Custom domain

email string? - Main email for this site

reply_to_email string? - Reply-to email for this site

allow_bundle_names boolean? - Are manual Bundle names allowed?

bundle_expiration int? - Site-wide Bundle expiration in days

overage_notify boolean? - Notify site email of overages?

welcome_email_enabled boolean? - Will the welcome email be sent to new users?

ask_about_overwrites boolean? - If false, rename conflicting files instead of asking for overwrite confirmation. Only applies to web interface.

show_request_access_link boolean? - Show request access link for users without access? Currently unused.

welcome_email_cc string? - Include this email in welcome emails if enabled

welcome_custom_text string? - Custom text send in user welcome email

language string? - Site default language

windows_mode_ftp boolean? - Does FTP user Windows emulation mode?

default_time_zone string? - Site default time zone

desktop_app boolean? - Is the desktop app enabled?

desktop_app_session_ip_pinning boolean? - Is desktop app session IP pinning enabled?

desktop_app_session_lifetime int? - Desktop app session lifetime (in hours)

mobile_app boolean? - Is the mobile app enabled?

mobile_app_session_ip_pinning boolean? - Is mobile app session IP pinning enabled?

mobile_app_session_lifetime int? - Mobile app session lifetime (in hours)

folder_permissions_groups_only boolean? - If true, permissions for this site must be bound to a group (not a user). Otherwise, permissions must be bound to a user.

welcome_screen string? - Does the welcome screen appear?

office_integration_available boolean? - Allow users to use Office for the web?

session_expiry decimal? - Session expiry in hours

ssl_required boolean? - Is SSL required? Disabling this is insecure.

tls_disabled boolean? - Is TLS disabled(site setting)?

user_lockout boolean? - Will users be locked out after incorrect login attempts?

user_lockout_tries int? - Number of login tries within user_lockout_within hours before users are locked out

user_lockout_within int? - Number of hours for user lockout window

user_lockout_lock_period int? - How many hours to lock user out for failed password?

include_password_in_welcome_email boolean? - Include password in emails to new users?

allowed_countries string? - Comma seperated list of allowed Country codes

allowed_ips string? - List of allowed IP addresses

disallowed_countries string? - Comma seperated list of disallowed Country codes

days_to_retain_backups int? - Number of days to keep deleted files

max_prior_passwords int? - Number of prior passwords to disallow

password_validity_days int? - Number of days password is valid

password_min_length int? - Shortest password length for users

password_require_letter boolean? - Require a letter in passwords?

password_require_mixed boolean? - Require lower and upper case letters in passwords?

password_require_special boolean? - Require special characters in password?

password_require_number boolean? - Require a number in passwords?

password_require_unbreached boolean? - Require passwords that have not been previously breached? (see https://haveibeenpwned.com/)

sftp_user_root_enabled boolean? - Use user FTP roots also for SFTP?

disable_password_reset boolean? - Is password reset disabled?

immutable_files boolean? - Are files protected from modification?

session_pinned_by_ip boolean? - Are sessions locked to the same IP? (i.e. do users need to log in again if they change IPs?)

bundle_password_required boolean? - Do Bundles require password protection?

bundle_require_share_recipient boolean? - Do Bundles require recipients for sharing?

password_requirements_apply_to_bundles boolean? - Require bundles' passwords, and passwords for other items (inboxes, public shares, etc.) to conform to the same requirements as users' passwords?

opt_out_global boolean? - Use servers in the USA only?

use_provided_modified_at boolean? - Allow uploaders to set provided_modified_at for uploaded files?

custom_namespace boolean? - Is this site using a custom namespace for users?

disable_users_from_inactivity_period_days int? - If greater than zero, users will unable to login if they do not show activity within this number of days.

non_sso_groups_allowed boolean? - If true, groups can be manually created / modified / deleted by Site Admins. Otherwise, groups can only be managed via your SSO provider.

non_sso_users_allowed boolean? - If true, users can be manually created / modified / deleted by Site Admins. Otherwise, users can only be managed via your SSO provider.

sharing_enabled boolean? - Allow bundle creation

user_requests_enabled boolean? - Enable User Requests feature

allowed_2fa_method_sms boolean? - Is SMS two factor authentication allowed?

allowed_2fa_method_u2f boolean? - Is U2F two factor authentication allowed?

allowed_2fa_method_totp boolean? - Is TOTP two factor authentication allowed?

allowed_2fa_method_yubi boolean? - Is yubikey two factor authentication allowed?

require_2fa boolean? - Require two-factor authentication for all users?

require_2fa_user_type string? - What type of user is required to use two-factor authentication (when require_2fa is set to true for this site)?

color2_top string? - Top bar background color

color2_left string? - Page link and button color

color2_link string? - Top bar link color

color2_text string? - Page link and button color

color2_top_text string? - Top bar text color

site_header string? - Custom site header text

site_footer string? - Custom site footer text

login_help_text string? - Login help text

smtp_address string? - SMTP server hostname or IP

smtp_authentication string? - SMTP server authentication type

smtp_from string? - From address to use when mailing through custom SMTP

smtp_username string? - SMTP server username

smtp_port int? - SMTP server port

ldap_enabled boolean? - Main LDAP setting: is LDAP enabled?

ldap_type string? - LDAP type

ldap_host string? - LDAP host

ldap_host_2 string? - LDAP backup host

ldap_host_3 string? - LDAP backup host

ldap_port int? - LDAP port

ldap_secure boolean? - Use secure LDAP?

ldap_username string? - Username for signing in to LDAP server.

ldap_username_field string? - LDAP username field

ldap_domain string? - Domain name that will be appended to usernames

ldap_user_action string? - Should we sync users from LDAP server?

ldap_group_action string? - Should we sync groups from LDAP server?

ldap_user_include_groups string? - Comma or newline separated list of group names (with optional wildcards) - if provided, only users in these groups will be added or synced.

ldap_group_exclusion string? - Comma or newline separated list of group names (with optional wildcards) to exclude when syncing.

ldap_group_inclusion string? - Comma or newline separated list of group names (with optional wildcards) to include when syncing.

ldap_base_dn string? - Base DN for looking up users in LDAP server

icon16_file string? -

icon16_delete boolean? - If true, will delete the file stored in icon16

icon32_file string? -

icon32_delete boolean? - If true, will delete the file stored in icon32

icon48_file string? -

icon48_delete boolean? - If true, will delete the file stored in icon48

icon128_file string? -

icon128_delete boolean? - If true, will delete the file stored in icon128

logo_file string? -

logo_delete boolean? - If true, will delete the file stored in logo

disable_2fa_with_delay boolean? - If set to true, we will begin the process of disabling 2FA on this site.

ldap_password_change string? - New LDAP password.

ldap_password_change_confirmation string? - Confirm new LDAP password.

smtp_password string? - Password for SMTP server.

files.com: SiteBody2

Fields

name string? - Site name

subdomain string? - Site subdomain

domain string? - Custom domain

email string? - Main email for this site

reply_to_email string? - Reply-to email for this site

allow_bundle_names boolean? - Are manual Bundle names allowed?

bundle_expiration int? - Site-wide Bundle expiration in days

overage_notify boolean? - Notify site email of overages?

welcome_email_enabled boolean? - Will the welcome email be sent to new users?

ask_about_overwrites boolean? - If false, rename conflicting files instead of asking for overwrite confirmation. Only applies to web interface.

show_request_access_link boolean? - Show request access link for users without access? Currently unused.

welcome_email_cc string? - Include this email in welcome emails if enabled

welcome_custom_text string? - Custom text send in user welcome email

language string? - Site default language

windows_mode_ftp boolean? - Does FTP user Windows emulation mode?

default_time_zone string? - Site default time zone

desktop_app boolean? - Is the desktop app enabled?

desktop_app_session_ip_pinning boolean? - Is desktop app session IP pinning enabled?

desktop_app_session_lifetime int? - Desktop app session lifetime (in hours)

mobile_app boolean? - Is the mobile app enabled?

mobile_app_session_ip_pinning boolean? - Is mobile app session IP pinning enabled?

mobile_app_session_lifetime int? - Mobile app session lifetime (in hours)

folder_permissions_groups_only boolean? - If true, permissions for this site must be bound to a group (not a user). Otherwise, permissions must be bound to a user.

welcome_screen string? - Does the welcome screen appear?

office_integration_available boolean? - Allow users to use Office for the web?

session_expiry decimal? - Session expiry in hours

ssl_required boolean? - Is SSL required? Disabling this is insecure.

tls_disabled boolean? - Is TLS disabled(site setting)?

user_lockout boolean? - Will users be locked out after incorrect login attempts?

user_lockout_tries int? - Number of login tries within user_lockout_within hours before users are locked out

user_lockout_within int? - Number of hours for user lockout window

user_lockout_lock_period int? - How many hours to lock user out for failed password?

include_password_in_welcome_email boolean? - Include password in emails to new users?

allowed_countries string? - Comma seperated list of allowed Country codes

allowed_ips string? - List of allowed IP addresses

disallowed_countries string? - Comma seperated list of disallowed Country codes

days_to_retain_backups int? - Number of days to keep deleted files

max_prior_passwords int? - Number of prior passwords to disallow

password_validity_days int? - Number of days password is valid

password_min_length int? - Shortest password length for users

password_require_letter boolean? - Require a letter in passwords?

password_require_mixed boolean? - Require lower and upper case letters in passwords?

password_require_special boolean? - Require special characters in password?

password_require_number boolean? - Require a number in passwords?

password_require_unbreached boolean? - Require passwords that have not been previously breached? (see https://haveibeenpwned.com/)

sftp_user_root_enabled boolean? - Use user FTP roots also for SFTP?

disable_password_reset boolean? - Is password reset disabled?

immutable_files boolean? - Are files protected from modification?

session_pinned_by_ip boolean? - Are sessions locked to the same IP? (i.e. do users need to log in again if they change IPs?)

bundle_password_required boolean? - Do Bundles require password protection?

bundle_require_share_recipient boolean? - Do Bundles require recipients for sharing?

password_requirements_apply_to_bundles boolean? - Require bundles' passwords, and passwords for other items (inboxes, public shares, etc.) to conform to the same requirements as users' passwords?

opt_out_global boolean? - Use servers in the USA only?

use_provided_modified_at boolean? - Allow uploaders to set provided_modified_at for uploaded files?

custom_namespace boolean? - Is this site using a custom namespace for users?

disable_users_from_inactivity_period_days int? - If greater than zero, users will unable to login if they do not show activity within this number of days.

non_sso_groups_allowed boolean? - If true, groups can be manually created / modified / deleted by Site Admins. Otherwise, groups can only be managed via your SSO provider.

non_sso_users_allowed boolean? - If true, users can be manually created / modified / deleted by Site Admins. Otherwise, users can only be managed via your SSO provider.

sharing_enabled boolean? - Allow bundle creation

user_requests_enabled boolean? - Enable User Requests feature

allowed_2fa_method_sms boolean? - Is SMS two factor authentication allowed?

allowed_2fa_method_u2f boolean? - Is U2F two factor authentication allowed?

allowed_2fa_method_totp boolean? - Is TOTP two factor authentication allowed?

allowed_2fa_method_yubi boolean? - Is yubikey two factor authentication allowed?

require_2fa boolean? - Require two-factor authentication for all users?

require_2fa_user_type string? - What type of user is required to use two-factor authentication (when require_2fa is set to true for this site)?

color2_top string? - Top bar background color

color2_left string? - Page link and button color

color2_link string? - Top bar link color

color2_text string? - Page link and button color

color2_top_text string? - Top bar text color

site_header string? - Custom site header text

site_footer string? - Custom site footer text

login_help_text string? - Login help text

smtp_address string? - SMTP server hostname or IP

smtp_authentication string? - SMTP server authentication type

smtp_from string? - From address to use when mailing through custom SMTP

smtp_username string? - SMTP server username

smtp_port int? - SMTP server port

ldap_enabled boolean? - Main LDAP setting: is LDAP enabled?

ldap_type string? - LDAP type

ldap_host string? - LDAP host

ldap_host_2 string? - LDAP backup host

ldap_host_3 string? - LDAP backup host

ldap_port int? - LDAP port

ldap_secure boolean? - Use secure LDAP?

ldap_username string? - Username for signing in to LDAP server.

ldap_username_field string? - LDAP username field

ldap_domain string? - Domain name that will be appended to usernames

ldap_user_action string? - Should we sync users from LDAP server?

ldap_group_action string? - Should we sync groups from LDAP server?

ldap_user_include_groups string? - Comma or newline separated list of group names (with optional wildcards) - if provided, only users in these groups will be added or synced.

ldap_group_exclusion string? - Comma or newline separated list of group names (with optional wildcards) to exclude when syncing.

ldap_group_inclusion string? - Comma or newline separated list of group names (with optional wildcards) to include when syncing.

ldap_base_dn string? - Base DN for looking up users in LDAP server

icon16_file string? -

icon16_delete boolean? - If true, will delete the file stored in icon16

icon32_file string? -

icon32_delete boolean? - If true, will delete the file stored in icon32

icon48_file string? -

icon48_delete boolean? - If true, will delete the file stored in icon48

icon128_file string? -

icon128_delete boolean? - If true, will delete the file stored in icon128

logo_file string? -

logo_delete boolean? - If true, will delete the file stored in logo

disable_2fa_with_delay boolean? - If set to true, we will begin the process of disabling 2FA on this site.

ldap_password_change string? - New LDAP password.

ldap_password_change_confirmation string? - Confirm new LDAP password.

smtp_password string? - Password for SMTP server.

files.com: SiteEntity

Show site settings

Fields

name string? - Site name

allowed_2fa_method_sms boolean? - Is SMS two factor authentication allowed?

allowed_2fa_method_totp boolean? - Is TOTP two factor authentication allowed?

allowed_2fa_method_u2f boolean? - Is U2F two factor authentication allowed?

allowed_2fa_method_yubi boolean? - Is yubikey two factor authentication allowed?

admin_user_id int? - User ID for the main site administrator

allow_bundle_names boolean? - Are manual Bundle names allowed?

allowed_countries string? - Comma seperated list of allowed Country codes

allowed_ips string? - List of allowed IP addresses

ask_about_overwrites boolean? - If false, rename conflicting files instead of asking for overwrite confirmation. Only applies to web interface.

bundle_expiration int? - Site-wide Bundle expiration in days

bundle_password_required boolean? - Do Bundles require password protection?

bundle_require_share_recipient boolean? - Do Bundles require recipients for sharing?

color2_left string? - Page link and button color

color2_link string? - Top bar link color

color2_text string? - Page link and button color

color2_top string? - Top bar background color

color2_top_text string? - Top bar text color

contact_name string? - Site main contact name

created_at string? - Time this site was created

currency string? - Preferred currency

custom_namespace boolean? - Is this site using a custom namespace for users?

days_to_retain_backups int? - Number of days to keep deleted files

default_time_zone string? - Site default time zone

desktop_app boolean? - Is the desktop app enabled?

desktop_app_session_ip_pinning boolean? - Is desktop app session IP pinning enabled?

desktop_app_session_lifetime int? - Desktop app session lifetime (in hours)

mobile_app boolean? - Is the mobile app enabled?

mobile_app_session_ip_pinning boolean? - Is mobile app session IP pinning enabled?

mobile_app_session_lifetime int? - Mobile app session lifetime (in hours)

disallowed_countries string? - Comma seperated list of disallowed Country codes

disable_notifications boolean? - Are notifications disabled?

disable_password_reset boolean? - Is password reset disabled?

domain string? - Custom domain

email string? - Main email for this site

reply_to_email string? - Reply-to email for this site

non_sso_groups_allowed boolean? - If true, groups can be manually created / modified / deleted by Site Admins. Otherwise, groups can only be managed via your SSO provider.

non_sso_users_allowed boolean? - If true, users can be manually created / modified / deleted by Site Admins. Otherwise, users can only be managed via your SSO provider.

folder_permissions_groups_only boolean? - If true, permissions for this site must be bound to a group (not a user). Otherwise, permissions must be bound to a user.

hipaa boolean? - Is there a signed HIPAA BAA between Files.com and this site?

icon128 ImageEntity? - Image entity

icon16 ImageEntity? - Image entity

icon32 ImageEntity? - Image entity

icon48 ImageEntity? - Image entity

immutable_files_set_at string? - Can files be modified?

include_password_in_welcome_email boolean? - Include password in emails to new users?

language string? - Site default language

ldap_base_dn string? - Base DN for looking up users in LDAP server

ldap_domain string? - Domain name that will be appended to usernames

ldap_enabled boolean? - Main LDAP setting: is LDAP enabled?

ldap_group_action string? - Should we sync groups from LDAP server?

ldap_group_exclusion string? - Comma or newline separated list of group names (with optional wildcards) to exclude when syncing.

ldap_group_inclusion string? - Comma or newline separated list of group names (with optional wildcards) to include when syncing.

ldap_host string? - LDAP host

ldap_host_2 string? - LDAP backup host

ldap_host_3 string? - LDAP backup host

ldap_port int? - LDAP port

ldap_secure boolean? - Use secure LDAP?

ldap_type string? - LDAP type

ldap_user_action string? - Should we sync users from LDAP server?

ldap_user_include_groups string? - Comma or newline separated list of group names (with optional wildcards) - if provided, only users in these groups will be added or synced.

ldap_username string? - Username for signing in to LDAP server.

ldap_username_field string? - LDAP username field

login_help_text string? - Login help text

logo ImageEntity? - Image entity

max_prior_passwords int? - Number of prior passwords to disallow

next_billing_amount decimal? - Next billing amount

next_billing_date string? - Next billing date

office_integration_available boolean? - Allow users to use Office for the web?

oncehub_link string? - Link to scheduling a meeting with our Sales team

opt_out_global boolean? - Use servers in the USA only?

overage_notified_at string? - Last time the site was notified about an overage

overage_notify boolean? - Notify site email of overages?

overdue boolean? - Is this site's billing overdue?

password_min_length int? - Shortest password length for users

password_require_letter boolean? - Require a letter in passwords?

password_require_mixed boolean? - Require lower and upper case letters in passwords?

password_require_number boolean? - Require a number in passwords?

password_require_special boolean? - Require special characters in password?

password_require_unbreached boolean? - Require passwords that have not been previously breached? (see https://haveibeenpwned.com/)

password_requirements_apply_to_bundles boolean? - Require bundles' passwords, and passwords for other items (inboxes, public shares, etc.) to conform to the same requirements as users' passwords?

password_validity_days int? - Number of days password is valid

phone string? - Site phone number

require_2fa boolean? - Require two-factor authentication for all users?

require_2fa_stop_time string? - If set, requirement for two-factor authentication has been scheduled to end on this date-time.

require_2fa_user_type string? - What type of user is required to use two-factor authentication (when require_2fa is set to true for this site)?

session SessionEntity? - Create user session (log in)

session_pinned_by_ip boolean? - Are sessions locked to the same IP? (i.e. do users need to log in again if they change IPs?)

sftp_user_root_enabled boolean? - Use user FTP roots also for SFTP?

sharing_enabled boolean? - Allow bundle creation

show_request_access_link boolean? - Show request access link for users without access? Currently unused.

site_footer string? - Custom site footer text

site_header string? - Custom site header text

smtp_address string? - SMTP server hostname or IP

smtp_authentication string? - SMTP server authentication type

smtp_from string? - From address to use when mailing through custom SMTP

smtp_port int? - SMTP server port

smtp_username string? - SMTP server username

session_expiry decimal? - Session expiry in hours

ssl_required boolean? - Is SSL required? Disabling this is insecure.

subdomain string? - Site subdomain

switch_to_plan_date string? - If switching plans, when does the new plan take effect?

tls_disabled boolean? - Is TLS disabled(site setting)?

trial_days_left int? - Number of days left in trial

trial_until string? - When does this Site trial expire?

updated_at string? - Last time this Site was updated

use_provided_modified_at boolean? - Allow uploaders to set provided_modified_at for uploaded files?

user UserEntity? - Create User

user_lockout boolean? - Will users be locked out after incorrect login attempts?

user_lockout_lock_period int? - How many hours to lock user out for failed password?

user_lockout_tries int? - Number of login tries within user_lockout_within hours before users are locked out

user_lockout_within int? - Number of hours for user lockout window

user_requests_enabled boolean? - Enable User Requests feature

welcome_custom_text string? - Custom text send in user welcome email

welcome_email_cc string? - Include this email in welcome emails if enabled

welcome_email_enabled boolean? - Will the welcome email be sent to new users?

welcome_screen string? - Does the welcome screen appear?

windows_mode_ftp boolean? - Does FTP user Windows emulation mode?

disable_users_from_inactivity_period_days int? - If greater than zero, users will unable to login if they do not show activity within this number of days.

files.com: SiteTestwebhookBody

Fields

url string - URL for testing the webhook.

method string? - HTTP method(GET or POST).

encoding string? - HTTP encoding method. Can be JSON, XML, or RAW (form data).

headers record {}? - Additional request headers.

body record {}? - Additional body parameters.

action string? - action for test body

files.com: SiteTestwebhookBody1

Fields

url string - URL for testing the webhook.

method string? - HTTP method(GET or POST).

encoding string? - HTTP encoding method. Can be JSON, XML, or RAW (form data).

headers record {}? - Additional request headers.

body record {}? - Additional body parameters.

action string? - action for test body

files.com: SiteTestwebhookBody2

Fields

url string - URL for testing the webhook.

method string? - HTTP method(GET or POST).

encoding string? - HTTP encoding method. Can be JSON, XML, or RAW (form data).

headers record {}? - Additional request headers.

body record {}? - Additional body parameters.

action string? - action for test body

files.com: SsoStrategyEntity

List Sso Strategies

Fields

protocol string? - SSO Protocol

provider string? - Provider name

label string? - Custom label for the SSO provider on the login page.

logo_url string? - URL holding a custom logo for the SSO provider on the login page.

id int? - ID

saml_provider_cert_fingerprint string? - Identity provider sha256 cert fingerprint if saml_provider_metadata_url is not available.

saml_provider_issuer_url string? - Identity provider issuer url

saml_provider_metadata_content string? - Custom identity provider metadata

saml_provider_metadata_url string? - Metadata URL for the SAML identity provider

saml_provider_slo_target_url string? - Identity provider SLO endpoint

saml_provider_sso_target_url string? - Identity provider SSO endpoint if saml_provider_metadata_url is not available.

scim_authentication_method string? - SCIM authentication type.

scim_username string? - SCIM username.

scim_oauth_access_token string? - SCIM OAuth Access Token.

scim_oauth_access_token_expires_at string? - SCIM OAuth Access Token Expiration Time.

subdomain string? - Subdomain

provision_users boolean? - Auto-provision users?

provision_groups boolean? - Auto-provision group membership based on group memberships on the SSO side?

deprovision_users boolean? - Auto-deprovision users?

deprovision_groups boolean? - Auto-deprovision group membership based on group memberships on the SSO side?

deprovision_behavior string? - Method used for deprovisioning users.

provision_group_default string? - Comma-separated list of group names for groups to automatically add all auto-provisioned users to.

provision_group_exclusion string? - Comma-separated list of group names for groups (with optional wildcards) that will be excluded from auto-provisioning.

provision_group_inclusion string? - Comma-separated list of group names for groups (with optional wildcards) that will be auto-provisioned.

provision_group_required string? - Comma or newline separated list of group names (with optional wildcards) to require membership for user provisioning.

provision_email_signup_groups string? - Comma-separated list of group names whose members will be created with email_signup authentication.

provision_site_admin_groups string? - Comma-separated list of group names whose members will be created as Site Admins.

provision_attachments_permission boolean? - DEPRECATED: Auto-provisioned users get Sharing permission. Use a Group with the Bundle permission instead.

provision_dav_permission boolean? - Auto-provisioned users get WebDAV permission?

provision_ftp_permission boolean? - Auto-provisioned users get FTP permission?

provision_sftp_permission boolean? - Auto-provisioned users get SFTP permission?

provision_time_zone string? - Default time zone for auto provisioned users.

provision_company string? - Default company for auto provisioned users.

ldap_base_dn string? - Base DN for looking up users in LDAP server

ldap_domain string? - Domain name that will be appended to LDAP usernames

enabled boolean? - Is strategy enabled?

ldap_host string? - LDAP host

ldap_host_2 string? - LDAP backup host

ldap_host_3 string? - LDAP backup host

ldap_port int? - LDAP port

ldap_secure boolean? - Use secure LDAP?

ldap_username string? - Username for signing in to LDAP server.

ldap_username_field string? - LDAP username field

files.com: StatusEntity

Test webhook.

Fields

code int? - Status HTTP code

message string? - Error message

status string? - Status message

data AutoEntity? - Auto fields.

errors ErrorsEntity? - Error fields.

clickwrap_id int? - Required Clickwrap id

clickwrap_body string? - Required Clickwrap body

files.com: StyleEntity

Show Style

Fields

id int? - Style ID

path string? - Folder path

logo ImageEntity? - Image entity

thumbnail ImageEntity? - Image entity

files.com: StylesStylepathBody

Fields

file string - Logo for custom branding.

files.com: StylesStylepathBody1

Fields

file string - Logo for custom branding.

files.com: StylesStylepathBody2

Fields

file string - Logo for custom branding.

files.com: SyncJobEntity

List Sync Jobs

Fields

queued_at string? - Job enqueued at

updated_at string? - Job updated at

status string? - Status of the job

regional_worker_status string? - Most recent reported status of sync worker

uuid string? - UUID

folder_behavior_id int? - Folder behaviour ID

files.com: UsageDailySnapshotEntity

List Usage Daily Snapshots

Fields

id int? - ID of the usage record

date string? - The date of this usage record

current_storage int? - The quantity of storage held for this site

usage_by_top_level_dir anydata[]? - Usage broken down by each top-level folder

files.com: UsageSnapshotEntity

List Usage Snapshots

Fields

id int? - Site usage ID

start_at string? - Site usage report start date/time

end_at string? - Site usage report end date/time

created_at string? - Site usage report created at date/time

high_water_user_count decimal? - Site usage report highest usage in time period

current_storage decimal? - Current site usage as of report

high_water_storage decimal? - Site usage report highest usage in time period

total_downloads int? - Number of downloads in report time period

total_uploads int? - Number of uploads in time period

updated_at string? - The last time this site usage report was updated

usage_by_top_level_dir record {}? - A map of root folders to their total usage

root_storage decimal? - Usage for root folder

deleted_files_counted_in_minimum decimal? - Usage for files that are deleted but uploaded within last 30 days

deleted_files_storage decimal? - Usage for files that are deleted but retained as backups

files.com: UserApiKeysBody

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

name string? - Internal name for the API Key. For your use.

expires_at string? - API Key expiration date

permission_set string? - Permissions for this API Key. Keys with the desktop_app permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations). Additional permission sets may become available in the future, such as for a Site Admin to give a key with no administrator privileges. If you have ideas for permission sets, please let us know.

path string? - Folder path restriction for this api key.

files.com: UserApiKeysBody1

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

name string? - Internal name for the API Key. For your use.

expires_at string? - API Key expiration date

permission_set string? - Permissions for this API Key. Keys with the desktop_app permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations). Additional permission sets may become available in the future, such as for a Site Admin to give a key with no administrator privileges. If you have ideas for permission sets, please let us know.

path string? - Folder path restriction for this api key.

files.com: UserApiKeysBody2

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

name string? - Internal name for the API Key. For your use.

expires_at string? - API Key expiration date

permission_set string? - Permissions for this API Key. Keys with the desktop_app permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations). Additional permission sets may become available in the future, such as for a Site Admin to give a key with no administrator privileges. If you have ideas for permission sets, please let us know.

path string? - Folder path restriction for this api key.

files.com: UserAs2KeysBody

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

as2_partnership_name string - AS2 Partnership Name

public_key string - Actual contents of Public key.

files.com: UserAs2KeysBody1

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

as2_partnership_name string - AS2 Partnership Name

public_key string - Actual contents of Public key.

files.com: UserAs2KeysBody2

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

as2_partnership_name string - AS2 Partnership Name

public_key string - Actual contents of Public key.

files.com: UserBody

Fields

avatar_file string? - An image file for your user avatar.

avatar_delete boolean? - If true, the avatar will be deleted.

change_password string? - Used for changing a password on an existing user.

change_password_confirmation string? - Optional, but if provided, we will ensure that it matches the value sent in change_password.

email string? - User's email.

grant_permission string? - Permission to grant on the user root. Can be blank or full, read, write, list, or history.

group_id int? - Group ID to associate this user with.

group_ids string? - A list of group ids to associate this user with. Comma delimited.

imported_password_hash string? - Pre-calculated hash of the user's password.

password string? - User password.

password_confirmation string? - Optional, but if provided, we will ensure that it matches the value sent in password.

announcements_read boolean? - Signifies that the user has read all the announcements in the UI.

allowed_ips string? - A list of allowed IPs if applicable. Newline delimited

attachments_permission boolean? - DEPRECATED: Can the user create Bundles (aka Share Links)? Use the bundle permission instead.

authenticate_until string? - Scheduled Date/Time at which user will be deactivated

authentication_method string? - How is this user authenticated?

billing_permission boolean? - Allow this user to perform operations on the account, payments, and invoices?

bypass_inactive_disable boolean? - Exempt this user from being disabled based on inactivity?

bypass_site_allowed_ips boolean? - Allow this user to skip site-wide IP blacklists?

dav_permission boolean? - Can the user connect with WebDAV?

disabled boolean? - Is user disabled? Disabled users cannot log in, and do not count for billing purposes. Users can be automatically disabled after an inactivity period via a Site setting.

ftp_permission boolean? - Can the user access with FTP/FTPS?

header_text string? - Text to display to the user in the header of the UI

language string? - Preferred language

notification_daily_send_time int? - Hour of the day at which daily notifications should be sent. Can be in range 0 to 23

name string? - User's full name

company string? - User's company

notes string? - Any internal notes on the user

office_integration_enabled boolean? - Enable integration with Office for the web?

password_validity_days int? - Number of days to allow user to use the same password

receive_admin_alerts boolean? - Should the user receive admin alerts such a certificate expiration notifications and overages?

require_password_change boolean? - Is a password change required upon next user login?

restapi_permission boolean? - Can this user access the REST API?

self_managed boolean? - Does this user manage it's own credentials or is it a shared/bot user?

sftp_permission boolean? - Can the user access with SFTP?

site_admin boolean? - Is the user an administrator for this site?

skip_welcome_screen boolean? - Skip Welcome page in the UI?

ssl_required string? - SSL required setting

sso_strategy_id int? - SSO (Single Sign On) strategy ID for the user, if applicable.

subscribe_to_newsletter boolean? - Is the user subscribed to the newsletter?

require_2fa string? - 2FA required setting

time_zone string? - User time zone

user_root string? - Root folder for FTP (and optionally SFTP if the appropriate site-wide setting is set.) Note that this is not used for API, Desktop, or Web interface.

username string? - User's username

files.com: UserBody1

Fields

avatar_file string? - An image file for your user avatar.

avatar_delete boolean? - If true, the avatar will be deleted.

change_password string? - Used for changing a password on an existing user.

change_password_confirmation string? - Optional, but if provided, we will ensure that it matches the value sent in change_password.

email string? - User's email.

grant_permission string? - Permission to grant on the user root. Can be blank or full, read, write, list, or history.

group_id int? - Group ID to associate this user with.

group_ids string? - A list of group ids to associate this user with. Comma delimited.

imported_password_hash string? - Pre-calculated hash of the user's password.

password string? - User password.

password_confirmation string? - Optional, but if provided, we will ensure that it matches the value sent in password.

announcements_read boolean? - Signifies that the user has read all the announcements in the UI.

allowed_ips string? - A list of allowed IPs if applicable. Newline delimited

attachments_permission boolean? - DEPRECATED: Can the user create Bundles (aka Share Links)? Use the bundle permission instead.

authenticate_until string? - Scheduled Date/Time at which user will be deactivated

authentication_method string? - How is this user authenticated?

billing_permission boolean? - Allow this user to perform operations on the account, payments, and invoices?

bypass_inactive_disable boolean? - Exempt this user from being disabled based on inactivity?

bypass_site_allowed_ips boolean? - Allow this user to skip site-wide IP blacklists?

dav_permission boolean? - Can the user connect with WebDAV?

disabled boolean? - Is user disabled? Disabled users cannot log in, and do not count for billing purposes. Users can be automatically disabled after an inactivity period via a Site setting.

ftp_permission boolean? - Can the user access with FTP/FTPS?

header_text string? - Text to display to the user in the header of the UI

language string? - Preferred language

notification_daily_send_time int? - Hour of the day at which daily notifications should be sent. Can be in range 0 to 23

name string? - User's full name

company string? - User's company

notes string? - Any internal notes on the user

office_integration_enabled boolean? - Enable integration with Office for the web?

password_validity_days int? - Number of days to allow user to use the same password

receive_admin_alerts boolean? - Should the user receive admin alerts such a certificate expiration notifications and overages?

require_password_change boolean? - Is a password change required upon next user login?

restapi_permission boolean? - Can this user access the REST API?

self_managed boolean? - Does this user manage it's own credentials or is it a shared/bot user?

sftp_permission boolean? - Can the user access with SFTP?

site_admin boolean? - Is the user an administrator for this site?

skip_welcome_screen boolean? - Skip Welcome page in the UI?

ssl_required string? - SSL required setting

sso_strategy_id int? - SSO (Single Sign On) strategy ID for the user, if applicable.

subscribe_to_newsletter boolean? - Is the user subscribed to the newsletter?

require_2fa string? - 2FA required setting

time_zone string? - User time zone

user_root string? - Root folder for FTP (and optionally SFTP if the appropriate site-wide setting is set.) Note that this is not used for API, Desktop, or Web interface.

username string? - User's username

files.com: UserBody2

Fields

avatar_file string? - An image file for your user avatar.

avatar_delete boolean? - If true, the avatar will be deleted.

change_password string? - Used for changing a password on an existing user.

change_password_confirmation string? - Optional, but if provided, we will ensure that it matches the value sent in change_password.

email string? - User's email.

grant_permission string? - Permission to grant on the user root. Can be blank or full, read, write, list, or history.

group_id int? - Group ID to associate this user with.

group_ids string? - A list of group ids to associate this user with. Comma delimited.

imported_password_hash string? - Pre-calculated hash of the user's password.

password string? - User password.

password_confirmation string? - Optional, but if provided, we will ensure that it matches the value sent in password.

announcements_read boolean? - Signifies that the user has read all the announcements in the UI.

allowed_ips string? - A list of allowed IPs if applicable. Newline delimited

attachments_permission boolean? - DEPRECATED: Can the user create Bundles (aka Share Links)? Use the bundle permission instead.

authenticate_until string? - Scheduled Date/Time at which user will be deactivated

authentication_method string? - How is this user authenticated?

billing_permission boolean? - Allow this user to perform operations on the account, payments, and invoices?

bypass_inactive_disable boolean? - Exempt this user from being disabled based on inactivity?

bypass_site_allowed_ips boolean? - Allow this user to skip site-wide IP blacklists?

dav_permission boolean? - Can the user connect with WebDAV?

disabled boolean? - Is user disabled? Disabled users cannot log in, and do not count for billing purposes. Users can be automatically disabled after an inactivity period via a Site setting.

ftp_permission boolean? - Can the user access with FTP/FTPS?

header_text string? - Text to display to the user in the header of the UI

language string? - Preferred language

notification_daily_send_time int? - Hour of the day at which daily notifications should be sent. Can be in range 0 to 23

name string? - User's full name

company string? - User's company

notes string? - Any internal notes on the user

office_integration_enabled boolean? - Enable integration with Office for the web?

password_validity_days int? - Number of days to allow user to use the same password

receive_admin_alerts boolean? - Should the user receive admin alerts such a certificate expiration notifications and overages?

require_password_change boolean? - Is a password change required upon next user login?

restapi_permission boolean? - Can this user access the REST API?

self_managed boolean? - Does this user manage it's own credentials or is it a shared/bot user?

sftp_permission boolean? - Can the user access with SFTP?

site_admin boolean? - Is the user an administrator for this site?

skip_welcome_screen boolean? - Skip Welcome page in the UI?

ssl_required string? - SSL required setting

sso_strategy_id int? - SSO (Single Sign On) strategy ID for the user, if applicable.

subscribe_to_newsletter boolean? - Is the user subscribed to the newsletter?

require_2fa string? - 2FA required setting

time_zone string? - User time zone

user_root string? - Root folder for FTP (and optionally SFTP if the appropriate site-wide setting is set.) Note that this is not used for API, Desktop, or Web interface.

username string? - User's username

files.com: UserCipherUseEntity

List User Cipher Uses

Fields

id int? - UserCipherUse ID

protocol_cipher string? - The protocol and cipher employed

created_at string? - The earliest recorded use of this combination of interface and protocol and cipher (for this user)

interface string? - The interface accessed

updated_at string? - The most recent use of this combination of interface and protocol and cipher (for this user)

user_id int? - ID of the user who performed this access

files.com: UserEntity

Create User

Fields

id int? - User ID

username string? - User's username

admin_group_ids int[]? - List of group IDs of which this user is an administrator

allowed_ips string? - A list of allowed IPs if applicable. Newline delimited

attachments_permission boolean? - DEPRECATED: Can the user create Bundles (aka Share Links)? Use the bundle permission instead.

api_keys_count int? - Number of api keys associated with this user

authenticate_until string? - Scheduled Date/Time at which user will be deactivated

authentication_method string? - How is this user authenticated?

avatar_url string? - URL holding the user's avatar

billing_permission boolean? - Allow this user to perform operations on the account, payments, and invoices?

bypass_site_allowed_ips boolean? - Allow this user to skip site-wide IP blacklists?

bypass_inactive_disable boolean? - Exempt this user from being disabled based on inactivity?

created_at string? - When this user was created

dav_permission boolean? - Can the user connect with WebDAV?

disabled boolean? - Is user disabled? Disabled users cannot log in, and do not count for billing purposes. Users can be automatically disabled after an inactivity period via a Site setting.

email string? - User email address

ftp_permission boolean? - Can the user access with FTP/FTPS?

group_ids string? - Comma-separated list of group IDs of which this user is a member

header_text string? - Text to display to the user in the header of the UI

language string? - Preferred language

last_login_at string? - User's last login time

last_protocol_cipher string? - The last protocol and cipher used

lockout_expires string? - Time in the future that the user will no longer be locked out if applicable

name string? - User's full name

company string? - User's company

notes string? - Any internal notes on the user

notification_daily_send_time int? - Hour of the day at which daily notifications should be sent. Can be in range 0 to 23

office_integration_enabled boolean? - Enable integration with Office for the web?

password_set_at string? - Last time the user's password was set

password_validity_days int? - Number of days to allow user to use the same password

public_keys_count int? - Number of public keys associated with this user

receive_admin_alerts boolean? - Should the user receive admin alerts such a certificate expiration notifications and overages?

require_2fa string? - 2FA required setting

active_2fa boolean? - Is 2fa active for the user?

require_password_change boolean? - Is a password change required upon next user login?

restapi_permission boolean? - Can this user access the REST API?

self_managed boolean? - Does this user manage it's own credentials or is it a shared/bot user?

sftp_permission boolean? - Can the user access with SFTP?

site_admin boolean? - Is the user an administrator for this site?

skip_welcome_screen boolean? - Skip Welcome page in the UI?

ssl_required string? - SSL required setting

sso_strategy_id int? - SSO (Single Sign On) strategy ID for the user, if applicable.

subscribe_to_newsletter boolean? - Is the user subscribed to the newsletter?

externally_managed boolean? - Is this user managed by a SsoStrategy?

time_zone string? - User time zone

type_of_2fa string? - Type(s) of 2FA methods in use. Will be either sms, totp, u2f, yubi, or multiple values sorted alphabetically and joined by an underscore.

user_root string? - Root folder for FTP (and optionally SFTP if the appropriate site-wide setting is set.) Note that this is not used for API, Desktop, or Web interface.

files.com: UserIdApiKeysBody

Fields

name string? - Internal name for the API Key. For your use.

expires_at string? - API Key expiration date

permission_set string? - Permissions for this API Key. Keys with the desktop_app permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations). Additional permission sets may become available in the future, such as for a Site Admin to give a key with no administrator privileges. If you have ideas for permission sets, please let us know.

path string? - Folder path restriction for this api key.

files.com: UserIdApiKeysBody1

Fields

name string? - Internal name for the API Key. For your use.

expires_at string? - API Key expiration date

permission_set string? - Permissions for this API Key. Keys with the desktop_app permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations). Additional permission sets may become available in the future, such as for a Site Admin to give a key with no administrator privileges. If you have ideas for permission sets, please let us know.

path string? - Folder path restriction for this api key.

files.com: UserIdApiKeysBody2

Fields

name string? - Internal name for the API Key. For your use.

expires_at string? - API Key expiration date

permission_set string? - Permissions for this API Key. Keys with the desktop_app permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations). Additional permission sets may become available in the future, such as for a Site Admin to give a key with no administrator privileges. If you have ideas for permission sets, please let us know.

path string? - Folder path restriction for this api key.

files.com: UserIdAs2KeysBody

Fields

as2_partnership_name string - AS2 Partnership Name

public_key string - Actual contents of Public key.

files.com: UserIdAs2KeysBody1

Fields

as2_partnership_name string - AS2 Partnership Name

public_key string - Actual contents of Public key.

files.com: UserIdAs2KeysBody2

Fields

as2_partnership_name string - AS2 Partnership Name

public_key string - Actual contents of Public key.

files.com: UserIdPublicKeysBody

Fields

title string - Internal reference for key.

public_key string - Actual contents of SSH key.

files.com: UserIdPublicKeysBody1

Fields

title string - Internal reference for key.

public_key string - Actual contents of SSH key.

files.com: UserIdPublicKeysBody2

Fields

title string - Internal reference for key.

public_key string - Actual contents of SSH key.

files.com: UserPublicKeysBody

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

title string - Internal reference for key.

public_key string - Actual contents of SSH key.

files.com: UserPublicKeysBody1

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

title string - Internal reference for key.

public_key string - Actual contents of SSH key.

files.com: UserPublicKeysBody2

Fields

user_id int? - User ID. Provide a value of 0 to operate the current session's user.

title string - Internal reference for key.

public_key string - Actual contents of SSH key.

files.com: UserRequestEntity

Create User Request

Fields

id int? - ID

name string? - User's full name

email string? - User email address

details string? - Details of the user's request

files.com: UserRequestsBody

Fields

name string - Name of user requested

email string - Email of user requested

details string - Details of the user request

files.com: UserRequestsBody1

Fields

name string - Name of user requested

email string - Email of user requested

details string - Details of the user request

files.com: UserRequestsBody2

Fields

name string - Name of user requested

email string - Email of user requested

details string - Details of the user request

files.com: UsersBody

Fields

avatar_file string? - An image file for your user avatar.

avatar_delete boolean? - If true, the avatar will be deleted.

change_password string? - Used for changing a password on an existing user.

change_password_confirmation string? - Optional, but if provided, we will ensure that it matches the value sent in change_password.

email string? - User's email.

grant_permission string? - Permission to grant on the user root. Can be blank or full, read, write, list, or history.

group_id int? - Group ID to associate this user with.

group_ids string? - A list of group ids to associate this user with. Comma delimited.

imported_password_hash string? - Pre-calculated hash of the user's password.

password string? - User password.

password_confirmation string? - Optional, but if provided, we will ensure that it matches the value sent in password.

announcements_read boolean? - Signifies that the user has read all the announcements in the UI.

allowed_ips string? - A list of allowed IPs if applicable. Newline delimited

attachments_permission boolean? - DEPRECATED: Can the user create Bundles (aka Share Links)? Use the bundle permission instead.

authenticate_until string? - Scheduled Date/Time at which user will be deactivated

authentication_method string? - How is this user authenticated?

billing_permission boolean? - Allow this user to perform operations on the account, payments, and invoices?

bypass_inactive_disable boolean? - Exempt this user from being disabled based on inactivity?

bypass_site_allowed_ips boolean? - Allow this user to skip site-wide IP blacklists?

dav_permission boolean? - Can the user connect with WebDAV?

disabled boolean? - Is user disabled? Disabled users cannot log in, and do not count for billing purposes. Users can be automatically disabled after an inactivity period via a Site setting.

ftp_permission boolean? - Can the user access with FTP/FTPS?

header_text string? - Text to display to the user in the header of the UI

language string? - Preferred language

notification_daily_send_time int? - Hour of the day at which daily notifications should be sent. Can be in range 0 to 23

name string? - User's full name

company string? - User's company

notes string? - Any internal notes on the user

office_integration_enabled boolean? - Enable integration with Office for the web?

password_validity_days int? - Number of days to allow user to use the same password

receive_admin_alerts boolean? - Should the user receive admin alerts such a certificate expiration notifications and overages?

require_password_change boolean? - Is a password change required upon next user login?

restapi_permission boolean? - Can this user access the REST API?

self_managed boolean? - Does this user manage it's own credentials or is it a shared/bot user?

sftp_permission boolean? - Can the user access with SFTP?

site_admin boolean? - Is the user an administrator for this site?

skip_welcome_screen boolean? - Skip Welcome page in the UI?

ssl_required string? - SSL required setting

sso_strategy_id int? - SSO (Single Sign On) strategy ID for the user, if applicable.

subscribe_to_newsletter boolean? - Is the user subscribed to the newsletter?

require_2fa string? - 2FA required setting

time_zone string? - User time zone

user_root string? - Root folder for FTP (and optionally SFTP if the appropriate site-wide setting is set.) Note that this is not used for API, Desktop, or Web interface.

username string? - User's username

files.com: UsersBody1

Fields

avatar_file string? - An image file for your user avatar.

avatar_delete boolean? - If true, the avatar will be deleted.

change_password string? - Used for changing a password on an existing user.

change_password_confirmation string? - Optional, but if provided, we will ensure that it matches the value sent in change_password.

email string? - User's email.

grant_permission string? - Permission to grant on the user root. Can be blank or full, read, write, list, or history.

group_id int? - Group ID to associate this user with.

group_ids string? - A list of group ids to associate this user with. Comma delimited.

imported_password_hash string? - Pre-calculated hash of the user's password.

password string? - User password.

password_confirmation string? - Optional, but if provided, we will ensure that it matches the value sent in password.

announcements_read boolean? - Signifies that the user has read all the announcements in the UI.

allowed_ips string? - A list of allowed IPs if applicable. Newline delimited

attachments_permission boolean? - DEPRECATED: Can the user create Bundles (aka Share Links)? Use the bundle permission instead.

authenticate_until string? - Scheduled Date/Time at which user will be deactivated

authentication_method string? - How is this user authenticated?

billing_permission boolean? - Allow this user to perform operations on the account, payments, and invoices?

bypass_inactive_disable boolean? - Exempt this user from being disabled based on inactivity?

bypass_site_allowed_ips boolean? - Allow this user to skip site-wide IP blacklists?

dav_permission boolean? - Can the user connect with WebDAV?

disabled boolean? - Is user disabled? Disabled users cannot log in, and do not count for billing purposes. Users can be automatically disabled after an inactivity period via a Site setting.

ftp_permission boolean? - Can the user access with FTP/FTPS?

header_text string? - Text to display to the user in the header of the UI

language string? - Preferred language

notification_daily_send_time int? - Hour of the day at which daily notifications should be sent. Can be in range 0 to 23

name string? - User's full name

company string? - User's company

notes string? - Any internal notes on the user

office_integration_enabled boolean? - Enable integration with Office for the web?

password_validity_days int? - Number of days to allow user to use the same password

receive_admin_alerts boolean? - Should the user receive admin alerts such a certificate expiration notifications and overages?

require_password_change boolean? - Is a password change required upon next user login?

restapi_permission boolean? - Can this user access the REST API?

self_managed boolean? - Does this user manage it's own credentials or is it a shared/bot user?

sftp_permission boolean? - Can the user access with SFTP?

site_admin boolean? - Is the user an administrator for this site?

skip_welcome_screen boolean? - Skip Welcome page in the UI?

ssl_required string? - SSL required setting

sso_strategy_id int? - SSO (Single Sign On) strategy ID for the user, if applicable.

subscribe_to_newsletter boolean? - Is the user subscribed to the newsletter?

require_2fa string? - 2FA required setting

time_zone string? - User time zone

user_root string? - Root folder for FTP (and optionally SFTP if the appropriate site-wide setting is set.) Note that this is not used for API, Desktop, or Web interface.

username string? - User's username

files.com: UsersBody2

Fields

avatar_file string? - An image file for your user avatar.

avatar_delete boolean? - If true, the avatar will be deleted.

change_password string? - Used for changing a password on an existing user.

change_password_confirmation string? - Optional, but if provided, we will ensure that it matches the value sent in change_password.

email string? - User's email.

grant_permission string? - Permission to grant on the user root. Can be blank or full, read, write, list, or history.

group_id int? - Group ID to associate this user with.

group_ids string? - A list of group ids to associate this user with. Comma delimited.

imported_password_hash string? - Pre-calculated hash of the user's password.

password string? - User password.

password_confirmation string? - Optional, but if provided, we will ensure that it matches the value sent in password.

announcements_read boolean? - Signifies that the user has read all the announcements in the UI.

allowed_ips string? - A list of allowed IPs if applicable. Newline delimited

attachments_permission boolean? - DEPRECATED: Can the user create Bundles (aka Share Links)? Use the bundle permission instead.

authenticate_until string? - Scheduled Date/Time at which user will be deactivated

authentication_method string? - How is this user authenticated?

billing_permission boolean? - Allow this user to perform operations on the account, payments, and invoices?

bypass_inactive_disable boolean? - Exempt this user from being disabled based on inactivity?

bypass_site_allowed_ips boolean? - Allow this user to skip site-wide IP blacklists?

dav_permission boolean? - Can the user connect with WebDAV?

disabled boolean? - Is user disabled? Disabled users cannot log in, and do not count for billing purposes. Users can be automatically disabled after an inactivity period via a Site setting.

ftp_permission boolean? - Can the user access with FTP/FTPS?

header_text string? - Text to display to the user in the header of the UI

language string? - Preferred language

notification_daily_send_time int? - Hour of the day at which daily notifications should be sent. Can be in range 0 to 23

name string? - User's full name

company string? - User's company

notes string? - Any internal notes on the user

office_integration_enabled boolean? - Enable integration with Office for the web?

password_validity_days int? - Number of days to allow user to use the same password

receive_admin_alerts boolean? - Should the user receive admin alerts such a certificate expiration notifications and overages?

require_password_change boolean? - Is a password change required upon next user login?

restapi_permission boolean? - Can this user access the REST API?

self_managed boolean? - Does this user manage it's own credentials or is it a shared/bot user?

sftp_permission boolean? - Can the user access with SFTP?

site_admin boolean? - Is the user an administrator for this site?

skip_welcome_screen boolean? - Skip Welcome page in the UI?

ssl_required string? - SSL required setting

sso_strategy_id int? - SSO (Single Sign On) strategy ID for the user, if applicable.

subscribe_to_newsletter boolean? - Is the user subscribed to the newsletter?

require_2fa string? - 2FA required setting

time_zone string? - User time zone

user_root string? - Root folder for FTP (and optionally SFTP if the appropriate site-wide setting is set.) Note that this is not used for API, Desktop, or Web interface.

username string? - User's username

files.com: UsersIdBody

Fields

avatar_file string? - An image file for your user avatar.

avatar_delete boolean? - If true, the avatar will be deleted.

change_password string? - Used for changing a password on an existing user.

change_password_confirmation string? - Optional, but if provided, we will ensure that it matches the value sent in change_password.

email string? - User's email.

grant_permission string? - Permission to grant on the user root. Can be blank or full, read, write, list, or history.

group_id int? - Group ID to associate this user with.

group_ids string? - A list of group ids to associate this user with. Comma delimited.

imported_password_hash string? - Pre-calculated hash of the user's password.

password string? - User password.

password_confirmation string? - Optional, but if provided, we will ensure that it matches the value sent in password.

announcements_read boolean? - Signifies that the user has read all the announcements in the UI.

allowed_ips string? - A list of allowed IPs if applicable. Newline delimited

attachments_permission boolean? - DEPRECATED: Can the user create Bundles (aka Share Links)? Use the bundle permission instead.

authenticate_until string? - Scheduled Date/Time at which user will be deactivated

authentication_method string? - How is this user authenticated?

billing_permission boolean? - Allow this user to perform operations on the account, payments, and invoices?

bypass_inactive_disable boolean? - Exempt this user from being disabled based on inactivity?

bypass_site_allowed_ips boolean? - Allow this user to skip site-wide IP blacklists?

dav_permission boolean? - Can the user connect with WebDAV?

disabled boolean? - Is user disabled? Disabled users cannot log in, and do not count for billing purposes. Users can be automatically disabled after an inactivity period via a Site setting.

ftp_permission boolean? - Can the user access with FTP/FTPS?

header_text string? - Text to display to the user in the header of the UI

language string? - Preferred language

notification_daily_send_time int? - Hour of the day at which daily notifications should be sent. Can be in range 0 to 23

name string? - User's full name

company string? - User's company

notes string? - Any internal notes on the user

office_integration_enabled boolean? - Enable integration with Office for the web?

password_validity_days int? - Number of days to allow user to use the same password

receive_admin_alerts boolean? - Should the user receive admin alerts such a certificate expiration notifications and overages?

require_password_change boolean? - Is a password change required upon next user login?

restapi_permission boolean? - Can this user access the REST API?

self_managed boolean? - Does this user manage it's own credentials or is it a shared/bot user?

sftp_permission boolean? - Can the user access with SFTP?

site_admin boolean? - Is the user an administrator for this site?

skip_welcome_screen boolean? - Skip Welcome page in the UI?

ssl_required string? - SSL required setting

sso_strategy_id int? - SSO (Single Sign On) strategy ID for the user, if applicable.

subscribe_to_newsletter boolean? - Is the user subscribed to the newsletter?

require_2fa string? - 2FA required setting

time_zone string? - User time zone

user_root string? - Root folder for FTP (and optionally SFTP if the appropriate site-wide setting is set.) Note that this is not used for API, Desktop, or Web interface.

username string? - User's username

files.com: UsersIdBody1

Fields

avatar_file string? - An image file for your user avatar.

avatar_delete boolean? - If true, the avatar will be deleted.

change_password string? - Used for changing a password on an existing user.

change_password_confirmation string? - Optional, but if provided, we will ensure that it matches the value sent in change_password.

email string? - User's email.

grant_permission string? - Permission to grant on the user root. Can be blank or full, read, write, list, or history.

group_id int? - Group ID to associate this user with.

group_ids string? - A list of group ids to associate this user with. Comma delimited.

imported_password_hash string? - Pre-calculated hash of the user's password.

password string? - User password.

password_confirmation string? - Optional, but if provided, we will ensure that it matches the value sent in password.

announcements_read boolean? - Signifies that the user has read all the announcements in the UI.

allowed_ips string? - A list of allowed IPs if applicable. Newline delimited

attachments_permission boolean? - DEPRECATED: Can the user create Bundles (aka Share Links)? Use the bundle permission instead.

authenticate_until string? - Scheduled Date/Time at which user will be deactivated

authentication_method string? - How is this user authenticated?

billing_permission boolean? - Allow this user to perform operations on the account, payments, and invoices?

bypass_inactive_disable boolean? - Exempt this user from being disabled based on inactivity?

bypass_site_allowed_ips boolean? - Allow this user to skip site-wide IP blacklists?

dav_permission boolean? - Can the user connect with WebDAV?

disabled boolean? - Is user disabled? Disabled users cannot log in, and do not count for billing purposes. Users can be automatically disabled after an inactivity period via a Site setting.

ftp_permission boolean? - Can the user access with FTP/FTPS?

header_text string? - Text to display to the user in the header of the UI

language string? - Preferred language

notification_daily_send_time int? - Hour of the day at which daily notifications should be sent. Can be in range 0 to 23

name string? - User's full name

company string? - User's company

notes string? - Any internal notes on the user

office_integration_enabled boolean? - Enable integration with Office for the web?

password_validity_days int? - Number of days to allow user to use the same password

receive_admin_alerts boolean? - Should the user receive admin alerts such a certificate expiration notifications and overages?

require_password_change boolean? - Is a password change required upon next user login?

restapi_permission boolean? - Can this user access the REST API?

self_managed boolean? - Does this user manage it's own credentials or is it a shared/bot user?

sftp_permission boolean? - Can the user access with SFTP?

site_admin boolean? - Is the user an administrator for this site?

skip_welcome_screen boolean? - Skip Welcome page in the UI?

ssl_required string? - SSL required setting

sso_strategy_id int? - SSO (Single Sign On) strategy ID for the user, if applicable.

subscribe_to_newsletter boolean? - Is the user subscribed to the newsletter?

require_2fa string? - 2FA required setting

time_zone string? - User time zone

user_root string? - Root folder for FTP (and optionally SFTP if the appropriate site-wide setting is set.) Note that this is not used for API, Desktop, or Web interface.

username string? - User's username

files.com: UsersIdBody2

Fields

avatar_file string? - An image file for your user avatar.

avatar_delete boolean? - If true, the avatar will be deleted.

change_password string? - Used for changing a password on an existing user.

change_password_confirmation string? - Optional, but if provided, we will ensure that it matches the value sent in change_password.

email string? - User's email.

grant_permission string? - Permission to grant on the user root. Can be blank or full, read, write, list, or history.

group_id int? - Group ID to associate this user with.

group_ids string? - A list of group ids to associate this user with. Comma delimited.

imported_password_hash string? - Pre-calculated hash of the user's password.

password string? - User password.

password_confirmation string? - Optional, but if provided, we will ensure that it matches the value sent in password.

announcements_read boolean? - Signifies that the user has read all the announcements in the UI.

allowed_ips string? - A list of allowed IPs if applicable. Newline delimited

attachments_permission boolean? - DEPRECATED: Can the user create Bundles (aka Share Links)? Use the bundle permission instead.

authenticate_until string? - Scheduled Date/Time at which user will be deactivated

authentication_method string? - How is this user authenticated?

billing_permission boolean? - Allow this user to perform operations on the account, payments, and invoices?

bypass_inactive_disable boolean? - Exempt this user from being disabled based on inactivity?

bypass_site_allowed_ips boolean? - Allow this user to skip site-wide IP blacklists?

dav_permission boolean? - Can the user connect with WebDAV?

disabled boolean? - Is user disabled? Disabled users cannot log in, and do not count for billing purposes. Users can be automatically disabled after an inactivity period via a Site setting.

ftp_permission boolean? - Can the user access with FTP/FTPS?

header_text string? - Text to display to the user in the header of the UI

language string? - Preferred language

notification_daily_send_time int? - Hour of the day at which daily notifications should be sent. Can be in range 0 to 23

name string? - User's full name

company string? - User's company

notes string? - Any internal notes on the user

office_integration_enabled boolean? - Enable integration with Office for the web?

password_validity_days int? - Number of days to allow user to use the same password

receive_admin_alerts boolean? - Should the user receive admin alerts such a certificate expiration notifications and overages?

require_password_change boolean? - Is a password change required upon next user login?

restapi_permission boolean? - Can this user access the REST API?

self_managed boolean? - Does this user manage it's own credentials or is it a shared/bot user?

sftp_permission boolean? - Can the user access with SFTP?

site_admin boolean? - Is the user an administrator for this site?

skip_welcome_screen boolean? - Skip Welcome page in the UI?

ssl_required string? - SSL required setting

sso_strategy_id int? - SSO (Single Sign On) strategy ID for the user, if applicable.

subscribe_to_newsletter boolean? - Is the user subscribed to the newsletter?

require_2fa string? - 2FA required setting

time_zone string? - User time zone

user_root string? - Root folder for FTP (and optionally SFTP if the appropriate site-wide setting is set.) Note that this is not used for API, Desktop, or Web interface.

username string? - User's username

files.com: WebhookTestBody

Fields

url string - URL for testing the webhook.

method string? - HTTP method(GET or POST).

encoding string? - HTTP encoding method. Can be JSON, XML, or RAW (form data).

headers record {}? - Additional request headers.

body record {}? - Additional body parameters.

action string? - action for test body

files.com: WebhookTestBody1

Fields

url string - URL for testing the webhook.

method string? - HTTP method(GET or POST).

encoding string? - HTTP encoding method. Can be JSON, XML, or RAW (form data).

headers record {}? - Additional request headers.

body record {}? - Additional body parameters.

action string? - action for test body

files.com: WebhookTestBody2

Fields

url string - URL for testing the webhook.

method string? - HTTP method(GET or POST).

encoding string? - HTTP encoding method. Can be JSON, XML, or RAW (form data).

headers record {}? - Additional request headers.

body record {}? - Additional body parameters.

action string? - action for test body

files.com: WebhookTestEntity

Create Webhook Test

Fields

code int? - Status HTTP code

message string? - Error message

status string? - Status message

data AutoEntity? - Auto fields.

success boolean? - The success status of the webhook test

files.com: WebhookTestsBody

Fields

url string - URL for testing the webhook.

method string? - HTTP method(GET or POST).

encoding string? - HTTP encoding method. Can be JSON, XML, or RAW (form data).

headers record {}? - Additional request headers.

body record {}? - Additional body parameters.

raw_body string? - raw body text

file_as_body boolean? - Send the file data as the request body?

file_form_field string? - Send the file data as a named parameter in the request POST body

action string? - action for test body

files.com: WebhookTestsBody1

Fields

url string - URL for testing the webhook.

method string? - HTTP method(GET or POST).

encoding string? - HTTP encoding method. Can be JSON, XML, or RAW (form data).

headers record {}? - Additional request headers.

body record {}? - Additional body parameters.

raw_body string? - raw body text

file_as_body boolean? - Send the file data as the request body?

file_form_field string? - Send the file data as a named parameter in the request POST body

action string? - action for test body

files.com: WebhookTestsBody2

Fields

url string - URL for testing the webhook.

method string? - HTTP method(GET or POST).

encoding string? - HTTP encoding method. Can be JSON, XML, or RAW (form data).

headers record {}? - Additional request headers.

body record {}? - Additional body parameters.

raw_body string? - raw body text

file_as_body boolean? - Send the file data as the request body?

file_form_field string? - Send the file data as a named parameter in the request POST body

action string? - action for test body

Import

import ballerinax/files.com;

Metadata

Released date: almost 2 years ago

Version: 1.5.1

License: Apache-2.0

Compatibility

Platform: any

Ballerina version: 2201.4.1

GraalVM compatible: Yes

Pull count

Total: 2

Current verison: 2

Weekly downloads

Source repository

Keywords

Content & Files/File Management & Storage

Cost/Paid

Contributors

Other versions

1.5.1

1.5.0 1.4.0 1.2.0 1.1.0

Dependencies

ballerina/url/2.2.3 ballerina/http/2.6.1

Cookie policy

Delete policy

clients

records

ballerinax/files.com Ballerina library

Overview

Prerequisites

Quickstart

Step 1: Import connector

Step 2: Create a new connector instance

Step 3: Invoke connector operation

Clients

files.com: Client

Constructor

postActionNotificationExports

Parameters

Return Type

getActionNotificationExportsId

Parameters

Return Type

getActionNotificationExportResults

Parameters

Return Type

postActionWebhookFailuresIdRetry

Parameters

Return Type

apiKeyFindCurrent

Return Type

apiKeyDeleteCurrent

Return Type

apiKeyUpdateCurrent

Parameters

Return Type

getApiKeysId

Parameters

Return Type

deleteApiKeysId

Parameters

Return Type

patchApiKeysId

Parameters

Return Type

getApiKeys

Parameters

Return Type

postApiKeys

Parameters

Return Type

getSiteUsage

Return Type

getSite

Return Type

patchSite

Parameters

Return Type

getSiteIpAddresses

Parameters

Return Type

getSiteDnsRecords

Parameters

Return Type

postSiteTestWebhook

Parameters

Return Type

getSiteApiKeys

Parameters

Return Type

postSiteApiKeys

Parameters

Return Type

patchUser

Parameters

Return Type

getUserPublicKeys

Parameters

Return Type

postUserPublicKeys

Parameters

Return Type

getUserGroups

Parameters

Return Type