Module dracoon.public
ballerinax/dracoon.public Ballerina library
1.5.2
Overview
The Dracoon API v4.28.3 connector(https://www.dracoon.com/en/home) OpenAPI specification.
Dracoon allows to store bussiness files using client sode encryption, file sharing and data access over cloud.
Ballerina connector for Dracoon allows integration with Dracoon REST API via Ballerina language.
Key Features
- Programmatic access to create and manage resources via REST API
- Manage user accounts and profiles
- Secure authentication with API key or OAuth support
Prerequisites
- Create an Dracoon account
- Obtaining tokens
- Use this guide to obtain the API key related to your account
Clients
dracoon.public: Client
Isolated
This is a generated connector from Dracoon API v4.28.3 OpenAPI specification.
REST Web Services for DRACOON. Developer Information Get SDKs on GitHub
Terms of service
Constructor
Gets invoked to initialize the connector.
The connector initialization requires setting the API credentials.
Create a Dracoon account and obtain OAuth tokens following this guide.
init (ConnectionConfig config, string serviceUrl)- config ConnectionConfig - The configurations to be used when initializing the
connector
- serviceUrl string "https://stats.bis.org/api/v1" - URL of the target service
requestPublicDownloadShareInfo
Isolated FunctionRemote Function
function requestPublicDownloadShareInfo(string accessKey, string? xSdsDateFormat) returns PublicDownloadShare|errorRequest public Download Share information
Parameters
- accessKey string - Access key
- xSdsDateFormat string? (default ()) - Date time format (cf. RFC 3339 & leettime.de)
Return Type
- PublicDownloadShare|error - OK
generateDownloadUrlPublic
Isolated FunctionRemote Function
function generateDownloadUrlPublic(string accessKey, PublicDownloadTokenGenerateRequest payload) returns PublicDownloadTokenGenerateResponse|errorGenerate download URL
Return Type
- PublicDownloadTokenGenerateResponse|error - Created
downloadFileViaTokenPublic
Isolated FunctionRemote Function
function downloadFileViaTokenPublic(string accessKey, string token, string? range, boolean? genericMimetype, boolean? inline) returns Response|errorDownload file with token
Parameters
- accessKey string - Access key
- token string - Download token
- range string? (default ()) - Range e.g.
bytes=0-999
- genericMimetype boolean? (default ()) - Always return
application/octet-streaminstead of specific mimetype
- inline boolean? (default ()) - Use Content-Disposition:
inlineinstead ofattachment
downloadfileviatokenpublic1
Isolated FunctionRemote Function
function downloadfileviatokenpublic1(string accessKey, string token, string? range, boolean? genericMimetype, boolean? inline) returns Response|errorDownload file with token
Parameters
- accessKey string - Access key
- token string - Download token
- range string? (default ()) - Range e.g.
bytes=0-999
- genericMimetype boolean? (default ()) - Always return
application/octet-streaminstead of specific mimetype
- inline boolean? (default ()) - Use Content-Disposition:
inlineinstead ofattachment
requestPublicUploadShareInfo
Isolated FunctionRemote Function
function requestPublicUploadShareInfo(string accessKey, string? xSdsSharePassword, string? xSdsDateFormat) returns PublicUploadShare|errorRequest public Upload Share information
Parameters
- accessKey string - Access key
- xSdsSharePassword string? (default ()) - Upload share password. Should be base64-encoded. Plain X-Sds-Share-Passwords are deprecated and will be removed in the future
- xSdsDateFormat string? (default ()) - Date time format (cf. RFC 3339 & leettime.de)
Return Type
- PublicUploadShare|error - OK
createShareUploadChannel
Isolated FunctionRemote Function
function createShareUploadChannel(string accessKey, CreateShareUploadChannelRequest payload) returns CreateShareUploadChannelResponse|errorCreate new file upload channel
Return Type
- CreateShareUploadChannelResponse|error - Created
requestUploadStatusPublic
Isolated FunctionRemote Function
function requestUploadStatusPublic(string accessKey, string uploadId) returns S3ShareUploadStatus|errorRequest status of S3 file upload
Return Type
- S3ShareUploadStatus|error - OK
completeFileUploadViaShare
Isolated FunctionRemote Function
function completeFileUploadViaShare(string accessKey, string uploadId, UserFileKeyList payload, string? xSdsDateFormat) returns PublicUploadedFileData|errorComplete file upload
Parameters
- accessKey string - Access key
- uploadId string - Upload channel ID
- payload UserFileKeyList - Mandatory for encrypted shares
- xSdsDateFormat string? (default ()) - Date time format (cf. RFC 3339 & leettime.de)
Return Type
- PublicUploadedFileData|error - Created
uploadfileasbinarypublic1
Isolated FunctionRemote Function
function uploadfileasbinarypublic1(string accessKey, string uploadId, AccessKeyUploadIdBody payload, string? xSdsDateFormat, string? contentRange) returns ChunkUploadResponse|errorUpload file
Parameters
- accessKey string - Access key
- uploadId string - Upload channel ID
- payload AccessKeyUploadIdBody - File
- xSdsDateFormat string? (default ()) - Date time format (cf. RFC 3339 & leettime.de)
- contentRange string? (default ()) - Content-Range e.g.
bytes 0-999/3980
Return Type
- ChunkUploadResponse|error - Created
cancelFileUploadViaShare
Isolated FunctionRemote Function
Cancel file upload
completeS3FileUploadViaShare
Isolated FunctionRemote Function
function completeS3FileUploadViaShare(string accessKey, string uploadId, CompleteS3ShareUploadRequest payload) returns Response|errorComplete S3 file upload
Parameters
- accessKey string - Access key
- uploadId string - Upload channel ID
- payload CompleteS3ShareUploadRequest -
generatePresignedUrlsPublic
Isolated FunctionRemote Function
function generatePresignedUrlsPublic(string accessKey, string uploadId, GeneratePresignedUrlsRequest payload, string? xSdsDateFormat) returns PresignedUrlList|errorGenerate presigned URLs for S3 file upload
Parameters
- accessKey string - Access key
- uploadId string - Upload channel ID
- payload GeneratePresignedUrlsRequest -
- xSdsDateFormat string? (default ()) - Date time format (cf. RFC 3339 & leettime.de)
Return Type
- PresignedUrlList|error - Created
requestThirdPartyDependencies
Isolated FunctionRemote Function
function requestThirdPartyDependencies() returns ThirdPartyDependenciesData[]|errorRequest third-party software dependencies
Return Type
- ThirdPartyDependenciesData[]|error - OK
requestSoftwareVersion
Isolated FunctionRemote Function
function requestSoftwareVersion(string? xSdsDateFormat) returns SoftwareVersionData|errorRequest software version information
Parameters
- xSdsDateFormat string? (default ()) - Date time format (cf. RFC 3339 & leettime.de)
Return Type
- SoftwareVersionData|error - OK
requestSystemInfo
Isolated FunctionRemote Function
function requestSystemInfo(boolean? isEnabled) returns SystemInfo|errorRequest system information
Parameters
- isEnabled boolean? (default ()) - Show only enabled authentication methods
Return Type
- SystemInfo|error - OK
requestActiveDirectoryAuthInfo
Isolated FunctionRemote Function
function requestActiveDirectoryAuthInfo(boolean? isGlobalAvailable) returns ActiveDirectoryAuthInfo|errorRequest Active Directory authentication information
Parameters
- isGlobalAvailable boolean? (default ()) - Show only global available items
Return Type
requestOpenIdAuthInfo
Isolated FunctionRemote Function
function requestOpenIdAuthInfo(boolean? isGlobalAvailable) returns OpenIdAuthInfo|errorRequest OpenID Connect provider authentication information
Parameters
- isGlobalAvailable boolean? (default ()) - Show only global available items
Return Type
- OpenIdAuthInfo|error - OK
requestSystemTime
Isolated FunctionRemote Function
function requestSystemTime(string? xSdsDateFormat) returns SdsServerTime|errorRequest system time
Parameters
- xSdsDateFormat string? (default ()) - Date time format (cf. RFC 3339 & leettime.de)
Return Type
- SdsServerTime|error - OK
Records
dracoon.public: AccessKeyUploadIdBody
Fields
- file? string -
dracoon.public: ActiveDirectory
Active Directory information
Fields
- alias string - Unique name for an Active Directory configuration
- id int - ID
- isGlobalAvailable boolean - Is available for all customers
dracoon.public: ActiveDirectoryAuthInfo
List of Active Directories
Fields
- items ActiveDirectory[] - List of available Active Directories
dracoon.public: ActiveDirectoryConfig
Active Directory configuration
Fields
- adExportGroup string - If
userImportis set totrue, the user must be member of this Active Directory group to receive a newly created DRACOON account.
- alias string - Unique name for an Active Directory configuration
- createHomeFolder boolean(default false) - Deprecated since v4.10.0 DEPRECATED, will be ignored Determines whether a room is created for each user that is created by automatic import (like a home folder). Room's name will equal the user's login name.
- homeFolderParent? int - Deprecated since v4.10.0 DEPRECATED, will be ignored ID of the room in which the individual rooms for users will be created.
- id int - ID
- ldapUsersDomain string - Search scope of Active Directory; only users below this node can log on.
- sdsImportGroup? int - User group that is assigned to users who are created by automatic import.
Reset with
0
- serverAdminName string - Distinguished Name (DN) of Active Directory administrative account
- serverIp string - IPv4 or IPv6 address or host name
- serverPort int - Port
- sslFingerPrint? string - SSL finger print of Active Directory server.
Mandatory for LDAPS connections.
Format:
Algorithm/Fingerprint
- useLdaps boolean - Determines whether LDAPS should be used instead of plain LDAP.
- userFilter string - Name of Active Directory attribute that is used as login name.
- userImport boolean - Determines if a DRACOON account is automatically created for a new user who successfully logs on with his / her AD / IDP account.
dracoon.public: ActiveDirectoryConfigList
List of Active Directory configurations
Fields
- items ActiveDirectoryConfig[] - List of Active Directory configurations
dracoon.public: AlgorithmVersionInfo
Algorithm information
Fields
- description string - Algorithm description
- status string - Algorithm status Derived from preference value and threshold
- 'version string - Algorithm version
dracoon.public: AlgorithmVersionInfoList
Information of all available algorithms
Fields
- fileKeyAlgorithms AlgorithmVersionInfo[] - List of file key algorithms
- keyPairAlgorithms AlgorithmVersionInfo[] - List of key pair algorithms
dracoon.public: AttributesResponse
Ranged list of attributes
Fields
- items KeyValueEntry[] - List of key-value pairs
- range Range - Range information
dracoon.public: AuditNodeResponse
Audit node report
Fields
- auditUserPermissionList AuditUserPermission[] - List of assigned users with permissions
- nodeCntChildren int - Number of direct children (no recursion; for rooms only)
- nodeCreatedAt? string - Creation date
- nodeCreatedBy? UserInfo - User information
- nodeHasActivitiesLog boolean(default true) - Is activities log active (for rooms only)
- nodeHasRecycleBin? boolean - Deprecated since v4.10.0 Is recycle bin active (for rooms only) Recycle bin is always on (disabling is not possible).
- nodeId int - Node ID
- nodeIsEncrypted? boolean - Encryption state
- nodeName string - Node name
- nodeParentId? int - Parent node ID (room or folder)
- nodeParentPath string - Parent node path
/if node is a root node (room)
- nodeQuota? int - Quota in byte
- nodeRecycleBinRetentionPeriod? int - Retention period for deleted nodes in days
- nodeSize? int - Node size in byte
- nodeUpdatedAt? string - Modification date
- nodeUpdatedBy? UserInfo - User information
dracoon.public: AuditUserPermission
Audit user permissions report
Fields
- permissions NodePermissions - Node permissions
- userFirstName string - User first name
- userId int - Unique identifier for the user
- userLastName string - User last name
- userLogin string - User login name
dracoon.public: AuthConfig
Authentication settings
Fields
- authMethods AuthMethod[] - List of authentication methods
dracoon.public: AuthMethod
Authentication method
Fields
- isEnabled boolean - Is enabled
- name string - Authentication methods:
-
basic -
active_directory -
radius -
openid
-
- priority int - Priority (smaller values have higher priority)
dracoon.public: AuthTokenRestrictions
Auth token restrictions
Fields
- accessTokenValidity? int - Since v4.13.0 Restricted OAuth access token validity (in seconds)
- refreshTokenValidity? int - Since v4.13.0 Restricted OAuth refresh token validity (in seconds)
- restrictionEnabled? boolean - Since v4.13.0 Defines if OAuth token restrictions are enabled
dracoon.public: Avatar
User avatar information
Fields
- avatarUri string - Avatar URI
- avatarUuid string - Avatar UUID
- isCustomAvatar boolean - Determines whether user updated his / her avatar with own image
dracoon.public: ChangeGroupMembersRequest
List of user IDs
Fields
- ids int[] - List of user IDs
dracoon.public: ChangeNodeCommentRequest
Request model for updating a node comment
Fields
- text string - Comment text
dracoon.public: ChangeUserPasswordRequest
Request model for updating user's password
Fields
- newPassword string - New password
- oldPassword string - Old password
dracoon.public: CharacterRules
Password character rules
Fields
- mustContainCharacters string[] - Characters which a password must contain:
-
alpha- at least one alphabetical character (uppercaseORlowercase) -
uppercase- at least one uppercase character -
lowercase- at least one lowercase character -
numeric- at least one numeric character -
special- at least one special character (letters and digits excluded) -
all- combination ofuppercase,lowercase,numericandspecial(available only in request models) -
none- none of the above
-
- numberOfCharacteristicsToEnforce int - Number of characteristics to enforce
e.g. from
["uppercase", "lowercase", "numeric", "special"]all 4 character sets can be enforced; but also only 2 of them
dracoon.public: ChunkUploadResponse
Chunk upload response
Fields
- hash string - Hash value of transferred chunk
- size int - Chunk size
dracoon.public: 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
dracoon.public: Comment
Node comment information
Fields
- createdAt string - Creation date
- createdBy UserInfo - User information
- id int - Comment ID
- isChanged boolean - Determines whether comment was edited or not
- isDeleted boolean - Determines whether comment was deleted or not
- text string - Comment text
- updatedAt string - Modification date
- updatedBy UserInfo - User information
dracoon.public: CommentList
List of node comments
Fields
- items Comment[] - List of node comments
- range Range - Range information
dracoon.public: CompleteS3FileUploadRequest
Request model for completing a S3 file upload
Fields
- fileKey? FileKey - File key information
- fileName? string - New file name to store with
- parts S3FileUploadPart[] - List of S3 file upload parts
- resolutionStrategy string(default "autorename") - Node conflict resolution strategy:
-
autorename -
overwrite -
fail
-
dracoon.public: CompleteS3ShareUploadRequest
Request model for completing a S3 file upload
Fields
- parts S3FileUploadPart[] - List of S3 file upload parts
- userFileKeyList? UserFileKey[] - List of user file keys
dracoon.public: CompleteUploadRequest
Request model for completing an upload
Fields
- fileKey? FileKey - File key information
- fileName? string - New file name to store with
- resolutionStrategy? string - Node conflict resolution strategy:
-
autorename -
overwrite -
fail
-
- userFileKeyList? UserFileKeyList - List of user file keys
dracoon.public: ConfigOptionList
List of key-value pairs
Fields
- items KeyValueEntry[] - List of key-value pairs
dracoon.public: ConfigRoomRequest
Request model for configuring a room
Fields
- adminGroupIds? int[] - List of group ids A room requires at least one admin (user or group)
- adminIds? int[] - List of user ids A room requires at least one admin (user or group)
- classification? int - Classification ID:
-
1- public -
2- internal -
3- confidential -
4- strictly confidential
-
- hasActivitiesLog? boolean - Is activities log active (for rooms only)
- hasRecycleBin? boolean - Deprecated since v4.10.0 Is recycle bin active (for rooms only) Recycle bin is always on (disabling is not possible).
- inheritPermissions? boolean - Inherit permissions from parent room
(default:
falseifparentIdis0; otherwise:true)
- newGroupMemberAcceptance? string - Behaviour when new users are added to the group:
-
autoallow -
pending
adminGroupIdshas items. -
- recycleBinRetentionPeriod? int - Retention period for deleted nodes in days
- takeOverPermissions? boolean - Take over existing permissions
dracoon.public: ConnectionConfig
Closed record
Provides a set of configurations for controlling the behaviours when communicating with a remote HTTP endpoint.
Fields
- auth BearerTokenConfig|OAuth2RefreshTokenGrantConfig - Configurations related to client authentication
- httpVersion HttpVersion(default http:HTTP_2_0) - The HTTP version understood by the client
- http1Settings? ClientHttp1Settings - Configurations related to HTTP/1.x protocol
- http2Settings? ClientHttp2Settings - Configurations related to HTTP/2 protocol
- timeout decimal(default 60) - The maximum time to wait (in seconds) for a response before closing the connection
- forwarded string(default "disable") - The choice of setting
forwarded/x-forwardedheader
- 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
dracoon.public: CopyNode
Copied node information
Fields
- id int - Source node ID
- name? string - New node name
- timestampCreation? string - Since v4.22.0 Time the node was created on external file system (default: current server datetime in UTC format)
- timestampModification? string - Since v4.22.0 Time the content of a node was last modified on external file system (default: current server datetime in UTC format)
dracoon.public: CopyNodesRequest
Request model for copying nodes
Fields
- items? CopyNode[] - List of nodes to be copied
- nodeIds? int[] - Deprecated since v4.5.0
Node IDs
Please use
itemsinstead.
- resolutionStrategy? string - Node conflict resolution strategy:
-
autorename -
overwrite -
fail
-
dracoon.public: CreateActiveDirectoryConfigRequest
Request model for creating an Active Directory configuration
Fields
- adExportGroup? string - If
userImportis set totrue, the user must be member of this Active Directory group to receive a newly created DRACOON account.
- alias string - Unique name for an Active Directory configuration
- createHomeFolder boolean(default false) - DEPRECATED, will be ignored Determines whether a room is created for each user that is created by automatic import (like a home folder). Room's name will equal the user's login name.
- homeFolderParent? int - DEPRECATED, will be ignored ID of the room in which the individual rooms for users will be created.
- ldapUsersDomain string - Search scope of Active Directory; only users below this node can log on.
- sdsImportGroup? int - User group that is assigned to users who are created by automatic import.
Reset with
0
- serverAdminName string - Distinguished Name (DN) of Active Directory administrative account
- serverAdminPassword string - Password of Active Directory administrative account
- serverIp string - IPv4 or IPv6 address or host name
- serverPort int - Port
- sslFingerPrint? string - SSL finger print of Active Directory server.
Mandatory for LDAPS connections.
Format:
Algorithm/Fingerprint
- useLdaps boolean(default false) - Determines whether LDAPS should be used instead of plain LDAP.
- userFilter string - Name of Active Directory attribute that is used as login name.
- userImport boolean(default false) - Determines if a DRACOON account is automatically created for a new user who successfully logs on with his / her AD / IDP account.
dracoon.public: CreateDownloadShareRequest
Request model for creating a Download Share
Fields
- creatorLanguage? string - Deprecated since v4.20.0 Language tag for messages to creator
- expiration? ObjectExpiration - Expiration information
- fileKey? FileKey - File key information
- internalNotes? string - Since v4.11.0 Internal notes
- keyPair? UserKeyPairContainer - Key pair container
- mailBody? string - Deprecated since v4.11.0 Notification email content
- mailRecipients? string - Deprecated since v4.11.0 CSV string of recipient email addresses
- mailSubject? string - Deprecated since v4.11.0 Notification email subject
- maxDownloads? int - Max allowed downloads
- name? string - Alias name (default: name of the shared node)
- nodeId int - Source node ID
- notes? string - User notes
- notifyCreator boolean(default false) - Deprecated since v4.20.0 Notify creator on every download.
- password? string - Access password, not allowed for encrypted shares
- receiverLanguage? string - Language tag for messages to receiver
- sendMail boolean(default false) - Deprecated since v4.11.0
Notify recipients via email
Please use
POST /shares/downloads/{share_id}/emailAPI instead.
- sendSms boolean(default false) - Deprecated since v4.11.0
Send share password via SMS
Please use
textMessageRecipientsattribute instead.
- showCreatorName boolean(default false) - Show creator first and last name.
- showCreatorUsername boolean(default false) - Show creator email address.
- smsRecipients? string - Deprecated since v4.11.0 CSV string of recipient MSISDNs
- textMessageRecipients? string[] - Since v4.11.0 List of recipient FQTNs E.123 / E.164 Format
dracoon.public: CreateFileUploadRequest
Request model for creating an upload channel
Fields
- classification? int - Classification ID:
-
1- public -
2- internal -
3- confidential -
4- strictly confidential
-
- directS3Upload boolean(default false) - Since v4.15.0 Upload direct to S3
- expiration? ObjectExpiration - Expiration information
- name string - File name
- notes? string - User notes Use empty string to remove.
- parentId int - Parent node ID (room or folder)
- size? int - File size in byte
- timestampCreation? string - Since v4.22.0 Time the node was created on external file system (default: current server datetime in UTC format)
- timestampModification? string - Since v4.22.0 Time the content of a node was last modified on external file system (default: current server datetime in UTC format)
dracoon.public: CreateFileUploadResponse
Upload channel information
Fields
- token string - Deprecated since v4.3.0 Upload token
- uploadId string - Upload (channel) ID
- uploadUrl string - (public) Upload URL
dracoon.public: CreateFolderRequest
Request model for creating a folder
Fields
- name string - Name
- notes? string - User notes Use empty string to remove.
- parentId int - Parent node ID (room or folder)
- timestampCreation? string - Since v4.22.0 Time the node was created on external file system (default: current server datetime in UTC format)
- timestampModification? string - Since v4.22.0 Time the content of a node was last modified on external file system (default: current server datetime in UTC format)
dracoon.public: CreateGroupRequest
Request model for creating a group
Fields
- expiration? ObjectExpiration - Expiration information
- name string - Group name
dracoon.public: CreateKeyPairRequest
Request model for creating a key pair
Fields
- previousPrivateKey PrivateKeyContainer - Private key container
- privateKeyContainer PrivateKeyContainer - Private key container
- publicKeyContainer PublicKeyContainer - Public key container
dracoon.public: CreateNodeCommentRequest
Request model for creating a node comment
Fields
- text string - Comment text
dracoon.public: CreateOAuthClientRequest
Request model for creating an OAuth client
Fields
- accessTokenValidity? int - Validity of the access token in seconds.
- approvalValidity? int - Since v4.22.0 Validity of the approval interval in seconds.
- clientId? string - ID of the OAuth client
- clientName string - Name, which is shown at the client configuration and authorization.
- clientSecret? string - Secret, which client uses at authentication.
- clientType? string - Determines whether client is a confidential or public client.
- redirectUris? string[] - URIs, to which a user is redirected after authorization.
- refreshTokenValidity? int - Validity of the refresh token in seconds.
dracoon.public: CreateOpenIdIdpConfigRequest
Request model for creating an OpenID Connect IDP configuration
Fields
- clientId string - ID of the OpenID client
- clientSecret string - Secret, which client uses at authentication.
- fallbackMappingClaim? string - Name of the claim which is used for the user mapping fallback.
- flow? string - Since v4.11.0 Flow, which is used at authentication
- issuer string - Issuer identifier of the IDP The value is a case sensitive URL.
- jwksEndPointUrl string - URL of the JWKS endpoint
- mappingClaim string - Name of the claim which is used for the user mapping.
- name string - Name of the IDP
- redirectUris string[] - URIs, to which a user is redirected after authorization.
- scopes string[] - List of requested scopes
- tokenEndPointUrl string - URL of the token endpoint
- userImportEnabled boolean(default false) - Determines if a DRACOON account is automatically created for a new user who successfully logs on with his / her AD / IDP account.
- userImportGroup? int - User group that is assigned to users who are created by automatic import.
Reset with
0
- userInfoEndPointUrl string - URL of the user info endpoint
- userInfoSource? string - Since v4.23.0 Source, which is used to get user information at the import or update of a user.
- userManagementUrl? string - URL of the user management UI. Use empty string to remove.
- userUpdateEnabled boolean(default false) - Determines if the DRACOON account is updated with data from AD / IDP.
For OpenID Connect, the scopes
emailandprofileare needed.
dracoon.public: CreateRoomRequest
Request model for creating a room
Fields
- adminGroupIds? int[] - List of group ids A room requires at least one admin (user or group)
- adminIds? int[] - List of user ids A room requires at least one admin (user or group)
- classification int(default 2) - Classification ID:
-
1- public -
2- internal -
3- confidential -
4- strictly confidential
-
- hasActivitiesLog boolean(default true) - Is activities log active (for rooms only)
- hasRecycleBin? boolean - Deprecated since v4.10.0 Is recycle bin active (for rooms only) Recycle bin is always on (disabling is not possible).
- inheritPermissions? boolean - Inherit permissions from parent room
(default:
falseifparentIdis0; otherwise:true)
- name string - Name
- newGroupMemberAcceptance string(default "autoallow") - Behaviour when new users are added to the group:
-
autoallow -
pending
adminGroupIdshas items. -
- notes? string - User notes Use empty string to remove.
- parentId? int - Parent room ID or
null(not 0) to create a top level room
- quota? int - Quota in byte
- recycleBinRetentionPeriod? int - Retention period for deleted nodes in days
- timestampCreation? string - Since v4.22.0 Time the node was created on external file system (default: current server datetime in UTC format)
- timestampModification? string - Since v4.22.0 Time the content of a node was last modified on external file system (default: current server datetime in UTC format)
dracoon.public: CreateShareUploadChannelRequest
Request model for creating an upload channel
Fields
- directS3Upload boolean(default false) - Since v4.15.0 Upload direct to S3
- name string - File name
- password? string - Password
- size? int - File size in byte
- timestampCreation? string - Since v4.22.0 Time the node was created on external file system (default: current server datetime in UTC format)
- timestampModification? string - Since v4.22.0 Time the content of a node was last modified on external file system (default: current server datetime in UTC format)
dracoon.public: CreateShareUploadChannelResponse
Upload channel information
Fields
- token? string - Deprecated since v4.3.0 Upload token
- uploadId string - Upload (channel) ID
- uploadUrl string - (public) Upload URL
dracoon.public: CreateUploadShareRequest
Request model for creating an Upload Share
Fields
- creatorLanguage? string - Deprecated since v4.20.0 Language tag for messages to creator
- expiration? ObjectExpiration - Expiration information
- filesExpiryPeriod? int - Number of days after which uploaded files expire
- internalNotes? string - Since v4.11.0 Internal notes
- mailBody? string - Deprecated since v4.11.0 Notification email content
- mailRecipients? string - Deprecated since v4.11.0 CSV string of recipient email addresses
- mailSubject? string - Deprecated since v4.11.0 Notification email subject
- maxSize? int - Maximal total size of uploaded files (in bytes)
- maxSlots? int - Maximal amount of files to upload
- name? string - Alias name (default: name of the shared node)
- notes? string - User notes
- notifyCreator boolean(default false) - Deprecated since v4.20.0 Notify creator on every upload.
- password? string - Password
- receiverLanguage? string - Language tag for messages to receiver
- sendMail boolean(default false) - Deprecated since v4.11.0
Notify recipients via email
Please use
POST /shares/uploads/{share_id}/emailAPI instead.
- sendSms boolean(default false) - Deprecated since v4.11.0
Send share password via SMS
Please use
textMessageRecipientsattribute instead.
- showCreatorName boolean(default false) - Since v4.11.0 Show creator first and last name.
- showCreatorUsername boolean(default false) - Since v4.11.0 Show creator email address.
- showUploadedFiles boolean(default false) - Allow display of already uploaded files
- smsRecipients? string - Deprecated since v4.11.0 CSV string of recipient MSISDNs
- targetId int - Target room or folder ID
- textMessageRecipients? string[] - Since v4.11.0 List of recipient FQTNs E.123 / E.164 Format
dracoon.public: CreateUserRequest
Request model for creating an user
Fields
- authData? UserAuthData - User Authentication Data
- authMethods? UserAuthMethod[] - Deprecated since v4.13.0
Authentication methods:
-
sql -
active_directory -
radius -
openid
authDatainstead -
- email? string - Email
- expiration? ObjectExpiration - Expiration information
- firstName string - User first name
- gender string(default "n") - Deprecated since v4.12.0
Gender
Do NOT use
gender! It will be ignored.
- isNonmemberViewer? boolean - Since v4.12.0 Determines whether user has the role NONMEMBER_VIEWER
- lastName string - User last name
- login? string - Deprecated since v4.13.0 User login name
- needsToChangePassword? boolean - Deprecated since v4.13.0
Determines whether user has to change his / her initial password.
use
authDate.mustChangePasswordinstead
- notifyUser? boolean - Since v4.9.0
Notify user about his new account
-
default:
trueforbasicauth type -
default:
falseforactive_directory,openidandradiusauth types
-
default:
- password? string - Deprecated since v4.13.0
An initial password may be preset
use
authDatainstead
- phone? string - Phone number
- receiverLanguage? string - IETF language tag
- title? string - Deprecated since v4.18.0 Job title
- userName? string - Since v4.13.0 Username
dracoon.public: CreateWebhookRequest
Request model for creating a webhook
Fields
- eventTypeNames string[] - List of names of event types
- isEnabled? boolean - Is enabled
- name string - Name
- secret? string - Secret; used for event message signatures
- triggerExampleEvent? boolean - If set to true, an example event is being created
- url string - URL (must begin with the
HTTPSscheme)
dracoon.public: Customer
Customer information
Fields
- activationCode? string - Deprecated since v4.8.0
Customer activation code string:
-
valid only for types
freeanddemo -
for
paycustomers it is empty
-
valid only for types
- companyName string - Company name
- createdAt string - Creation date
- customerAttributes? CustomerAttributes - List of customer attributes
- customerContractType string - Customer type
- customerUuid string - Since v4.21.0 Customer UUID
- id int - Unique identifier for the customer
- isLocked boolean(default false) - Customer is locked:
-
false- unlocked -
true- locked
-
- lastLoginAt? string - Date of last seen login for the customer
- lockStatus boolean - Deprecated since v4.7.0
Customer lock status:
-
false- unlocked -
true- locked
isLockedinstead. All users of this customer will be blocked and can not login anymore. -
- providerCustomerId? string - Provider customer ID
- quotaMax int - Maximal disc space which can be allocated by customer in bytes. -1 for unlimited
- quotaUsed int - Used amount of disc space in bytes
- trialDaysLeft? int - Number of days left for trial period (relevant only for type
demo) (not used)
- updatedAt? string - Modification date
- userMax int - Maximal number of users
- userUsed int - Number of users which are already allocated.
- webhooksMax? int - Since v4.19.0 Maximal number of webhooks
dracoon.public: CustomerAttributes
List of customer attributes
Fields
- items KeyValueEntry[] - List of customer attributes
dracoon.public: CustomerData
Customer information
Fields
- accountsLimit int - User accounts limit
- accountsUsed int - User accounts used
- cntFiles? int - Deprecated since v4.11.0 Total number of files Visible only with at least one global role.
- cntFolders? int - Deprecated since v4.11.0 Total number of folders Visible only with at least one global role.
- cntRooms? int - Deprecated since v4.11.0 Total number of rooms Visible only with at least one global role.
- customerEncryptionEnabled boolean - Clientside encryption for customer enabled
- id int - Unique identifier for the customer
- isProviderCustomer boolean - Customer is Provider Customer
- name string - Customer name
- spaceLimit int - Space limit (in bytes). -1 for unlimited
- spaceUsed int - Space used (in bytes)
dracoon.public: CustomerList
List of customers
Fields
- items Customer[] - List of customers
- range Range - Range information
dracoon.public: CustomerSettingsRequest
Request model for setting the customer settings
Fields
- homeRoomParentName? string - Homeroom Parent Name
- homeRoomQuota? int - Homeroom Quota in bytes
- homeRoomsActive? boolean - Homerooms active
dracoon.public: CustomerSettingsResponse
Customer settings
Fields
- homeRoomParentId? int - Homeroom Parent ID
- homeRoomParentName? string - Homeroom Parent Name
- homeRoomQuota? int - Homeroom Quota in bytes
- homeRoomsActive boolean - Homerooms active
dracoon.public: DeleteDeletedNodesRequest
Request model for deleting nodes from recycle bin
Fields
- deletedNodeIds int[] - List of deleted node IDs
dracoon.public: DeletedNode
Deleted node information (Deleted node can be a folder or file)
Fields
- accessedAt? string - Last access date
- classification? int - Classification ID:
-
1- public -
2- internal -
3- confidential -
4- strictly confidential
-
- createdAt? string - Creation date
- createdBy? UserInfo - User information
- deletedAt? string - Deletion date
- deletedBy? UserInfo - User information
- expireAt? string - Expiration date
- id? int - Node ID
- isEncrypted? boolean - Encryption state
- name string - Node name
- notes? string - User notes
- parentId int - Parent node ID (room or folder)
- parentPath string - Parent node path
/if node is a root node (room)
- size? int - Node size in byte
- 'type string - Node type
- updatedAt? string - Modification date
- updatedBy? UserInfo - User information
dracoon.public: DeletedNodeSummary
Deleted node information (Deleted node can be a folder or file)
Fields
- cntVersions int - Number of deleted versions of this file
- firstDeletedAt string - First deleted version
- lastDeletedAt string - Last deleted version
- lastDeletedNodeId int - Node ID of last deleted version
- name string - Node name
- parentId int - Parent node ID (room or folder)
- parentPath string - Parent node path
/if node is a root node (room)
- timestampCreation? string - Since v4.22.0 Time the node was created on external file system
- timestampModification? string - Since v4.22.0 Time the content of a node was last modified on external file system
- 'type string - Node type
dracoon.public: DeletedNodeSummaryList
List of deleted nodes
Fields
- items DeletedNodeSummary[] - List of deleted nodes (summary)
- range Range - Range information
dracoon.public: DeletedNodeVersionsList
List of deleted versions of nodes
Fields
- items DeletedNode[] - List of deleted nodes
- range Range - Range information
dracoon.public: DeleteDownloadSharesRequest
Request model for deleting Download Shares
Fields
dracoon.public: DeleteNodesRequest
Request model for deleting nodes
Fields
- nodeIds int[] - List of node IDs
dracoon.public: DeleteUploadSharesRequest
Request model for deleting Upload Shares
Fields
dracoon.public: DownloadShare
Download Share information
Fields
- accessKey string - Share access key to generate secure link
- classification? int - Deprecated since v4.11.0
Classification ID:
-
1- public -
2- internal -
3- confidential -
4- strictly confidential
-
- cntDownloads int - Downloads counter (incremented on each download)
- createdAt string - Creation date
- createdBy UserInfo - User information
- dataUrl? string - Path to shared download node
- expireAt? string - Expiration date
- id int - Share ID
- internalNotes? string - Since v4.11.0 Internal notes
- isEncrypted? boolean - Encrypted share (this only applies to shared files, not folders)
- isProtected? boolean - Is share protected by password
- maxDownloads? int - Max allowed downloads
- name string - Alias name
- nodeId int - Source node ID
- nodePath? string - Path to shared download node
- nodeType? string - Node type
- notes? string - User notes
- notifyCreator boolean - Deprecated since v4.20.0 Notify creator on every download.
- recipients? string - Deprecated since v4.11.0 CSV string of recipient email addresses
- showCreatorName? boolean - Show creator first and last name.
- showCreatorUsername? boolean - Show creator email address.
- smsRecipients? string - Deprecated since v4.11.0 CSV string of recipient MSISDNs
- updatedAt? string - Modification date
- updatedBy? UserInfo - User information
dracoon.public: DownloadShareLinkEmail
Request model for sending an email of a Download Share link
Fields
- body string - Notification email content
- receiverLanguage? string - Language tag for messages to receiver
- recipients string[] - List of recipient email addresses
dracoon.public: DownloadShareList
List of Download Shares
Fields
- items DownloadShare[] - List of Download Shares
- range Range - Range information
dracoon.public: DownloadTokenGenerateResponse
Download URL
Fields
- downloadUrl string - Download URL
- token string - Deprecated since v4.3.0 Download token
dracoon.public: EnableCustomerEncryptionRequest
Request model for enabling customer encryption
Fields
- dataSpaceRescueKey UserKeyPairContainer - Key pair container
- enableCustomerEncryption boolean - Set
trueto enable encryption for this customer
dracoon.public: EncryptionInfo
Encryption states
Fields
- dataSpaceKeyState string - DRACOON key state
- roomKeyState string - Room key state
- userKeyState string - User key state
dracoon.public: EncryptionPasswordPolicies
Encryption password policies
Fields
- characterRules? CharacterRules - Password character rules
- minLength? int - Minimum number of characters a password must contain
- rejectKeyboardPatterns? boolean - Determines whether a password must NOT contain keyboard patterns (e.g.
qwertz,asdf) (min. 4 character pattern)
- rejectUserInfo? boolean - Determines whether a password must NOT contain user info (first name, last name, email, user name)
- updatedAt? string - Modification date
- updatedBy? UserInfo - User information
dracoon.public: EncryptRoomRequest
Request model for handling encryption settings for a room
Fields
- dataRoomRescueKey? UserKeyPairContainer - Key pair container
- isEncrypted boolean - Encryption state
- useDataSpaceRescueKey? boolean - Use system emergency password (rescue key) for files in this room
dracoon.public: ErrorResponse
Error information
Fields
- code int - HTTP status code
- debugInfo? string - Debug information
- errorCode? int - Internal error code
- message string - HTTP status code description
dracoon.public: EventlogConfig
Eventlog settings
Fields
- enabled? boolean - Is eventlog enabled?
- logIpEnabled? boolean - Determines whether user’s IP address is logged.
- retentionPeriod? int - Retention period (in days) of event log entries. After that period, all entries are deleted. Recommended value: 7
dracoon.public: EventType
Event type information
Fields
- id int - ID
- name string - Name
- usableCustomerAdminWebhook boolean - Usable as customer admin webhook
- usableNodeWebhook boolean - Usable as node webhook
- usablePushNotification boolean - Usable as push notification
- usableTenantWebhook boolean - Usable as tenant webhook
dracoon.public: EventTypeList
List of event types
Fields
- items EventType[] - List of event types
dracoon.public: FailoverServer
Failover server information
Fields
- failoverEnabled boolean - RADIUS Failover Server is active
- failoverIpAddress string - RADIUS Failover Server IP Address Required if failover server is enabled.
- failoverPort int - RADIUS Failover Server Port Required if failover server is enabled.
dracoon.public: FileFileKeys
File key information
Fields
- fileKeyContainer? FileKeyContainer - File key container
- id? int - File ID
dracoon.public: FileKey
File key information
Fields
- iv string - Initial vector
- 'key string - Encryption key
- tag string - Authentication tag (needed with authenticated encryption)
- 'version string - Version
dracoon.public: FileKeyContainer
File key container
Fields
- iv string - Initial vector
- 'key string - Encryption key
- tag? string - Authentication tag (needed with authenticated encryption)
- 'version string - Version
dracoon.public: FirstAdminUser
First administrator user
Fields
- authData? UserAuthData - User Authentication Data
- authMethods? UserAuthMethod[] - Deprecated since v4.13.0
Authentication methods:
-
sql -
active_directory -
radius -
openid
authDatainstead -
- email? string - Email
- firstName string - User first name
- gender string(default "n") - Deprecated since v4.12.0 Gender
- language? string - Deprecated since v4.7.0 Language ID or ISO 639-1 code
- lastName string - User last name
- login? string - Deprecated since v4.13.0 User login name
- needsToChangePassword? boolean - Deprecated since v4.13.0
Determines whether user has to change his / her initial password.
use
authDate.mustChangePasswordinstead
- needsToChangeUserName boolean(default false) - Deprecated since v4.13.0
If
true, the user must change theuserNameat the first login.
- notifyUser? boolean - Notify user about his new account
-
default:
trueforbasicauth type -
default:
falseforactive_directory,openidandradiusauth types
-
default:
- password? string - Deprecated since v4.13.0
An initial password may be preset
use
authDatainstead
- phone? string - Phone number
- receiverLanguage? string - IETF language tag
- title? string - Deprecated since v4.18.0 Job title
- userName? string - Since v4.13.0 Username
dracoon.public: GeneralSettings
General settings
Fields
- authTokenRestrictions? AuthTokenRestrictions - Auth token restrictions
- cryptoEnabled? boolean - Activation status of client-side encryption. Can only be enabled once; disabling is not possible.
- emailNotificationButtonEnabled? boolean - Enable email notification button
- eulaEnabled? boolean - Each user has to confirm the EULA at first login.
- hideLoginInputFields? boolean - Since v4.13.0 Defines if login fields should be hidden
- mediaServerEnabled? boolean - Deprecated since v4.12.0 Determines if the media server is enabled
- s3TagsEnabled? boolean - Since v4.9.0 Defines if S3 tags are enabled
- useS3Storage? boolean - Defines if S3 is used as storage backend
- weakPasswordEnabled? boolean - Deprecated since v4.14.0
Allow weak password
- A weak password has to fulfill the following criteria:
- is at least 8 characters long
- contains letters and numbers
- A strong password has to fulfill the following criteria in addition:
- contains at least one special character
- contains upper and lower case characters
GET /system/config/policies/passwordsAPI to get configured password policies.
dracoon.public: GeneralSettingsInfo
General settings
Fields
- cryptoEnabled? boolean - Activation status of client-side encryption. Can only be enabled once; disabling is not possible.
- emailNotificationButtonEnabled? boolean - Enable email notification button
- eulaEnabled? boolean - Each user has to confirm the EULA at first login.
- homeRoomParentId? int - Since v4.10.0 Homeroom Parent ID
- homeRoomsActive? boolean - Since v4.10.0 Homerooms active
- mediaServerEnabled? boolean - Deprecated since v4.12.0 Determines if the media server is enabled
- s3TagsEnabled? boolean - Since v4.9.0 Defines if S3 tags are enabled
- useS3Storage? boolean - Defines if S3 is used as storage backend
- weakPasswordEnabled? boolean - Allow weak password
- A weak password has to fulfill the following criteria:
- is at least 8 characters long
- contains letters and numbers
- A strong password has to fulfill the following criteria in addition:
- contains at least one special character
- contains upper and lower case characters
dracoon.public: GeneratePresignedUrlsRequest
Request model for generating presigned URLs
Fields
- firstPartNumber int - First part number of a range of requested presigned URLs (for S3 it is:
1)
- lastPartNumber int - Last part number of a range of requested presigned URLs
- size int -
Content-Lengthheader size for each presigned URL (in bytes) MUST be >= 5 MB except the last part.
dracoon.public: Group
Group information
Fields
- cntUsers int - Amount of users
- createdAt string - Creation date
- createdBy UserInfo - User information
- expireAt? string - Expiration date
- groupRoles? RoleList - List of roles
- id int - Unique identifier for the group
- name string - Group name
- updatedAt? string - Modification date
- updatedBy? UserInfo - User information
dracoon.public: GroupIds
List of group IDs
Fields
- ids int[] - List of group IDs
dracoon.public: GroupInfo
Group information
Fields
- id int - Unique identifier for the group
- name string - Group name
dracoon.public: GroupList
List of groups
Fields
- items Group[] - List of groups
- range Range - Range information
dracoon.public: GroupUser
User information
Fields
- displayName string - Deprecated since v4.11.0
Display name
use information from
UserInfoinstead to combine a display name
- email string - Deprecated since v4.11.0
Email
use
emailfromUserInfoinstead
- id int - Deprecated since v4.11.0
Unique identifier for the user
use
idfromUserInfoinstead
- isMember boolean - Determines whether user is a member of the group or not
- login string - Deprecated since v4.11.0 User login name
- userInfo UserInfo - User information
dracoon.public: GroupUserList
List of users
Fields
- items GroupUser[] - List of group-user mappings
- range Range - Range information
dracoon.public: InfrastructureProperties
Infrastructure properties
Fields
- isDracoonCloud? boolean - Since v4.21.0 Determines if the DRACOON Core is deployed in the cloud environment
- mediaServerConfigEnabled? boolean - Determines if the media server is enabled
- s3DefaultRegion? string - Suggested S3 Region
- s3EnforceDirectUpload? boolean - Since v4.15.0 Enforce direct upload to S3
- smsConfigEnabled? boolean - Allow sending of share passwords via SMS
- tenantUuid? string - Since v4.21.0 Current tenant UUID
dracoon.public: KeyValueEntry
Key-value pair
Fields
- 'key string - Entry key
- value string - Entry value
dracoon.public: LastAdminGroupRoom
Room information
Fields
- id int - Room ID
- name string - Room name
- parentId? int - Parent room ID
- parentPath string - Parent node path
/if node is a root node (room)
dracoon.public: LastAdminGroupRoomList
List of (last admin group) rooms
Fields
- items LastAdminGroupRoom[] - List of last admin rooms
dracoon.public: LastAdminUserRoom
Room information
Fields
- id int - Room ID
- lastAdminInGroup boolean - Determines whether user is last admin of a room due to being the last member of last admin group
- lastAdminInGroupId? int - ID of the last admin group where the user is the only remaining member
(returned only if
lastAdminInGroupistrue)
- name string - Room name
- parentId? int - Parent room ID
- parentPath string - Parent node path
/if node is a root node (room)
dracoon.public: LastAdminUserRoomList
List of (last admin user) rooms
Fields
- items LastAdminUserRoom[] - List of last admin rooms
dracoon.public: LogEvent
Log event information
Fields
- attribute1? string - Attribute 1
- attribute2? string - Attribute 2
- attribute3? string - Attribute 3
- authParentSource? string - Auth parent source ID
- authParentTarget? string - Auth parent target ID
- customerId? int - Unique identifier for the customer
- id int - Event ID
- message string - Event description
- objectId1? int - Object ID 1
- objectId2? int - Object ID 2
- objectName1? string - Object name 1
- objectName2? string - Object name 2
- objectType1? int - Object type 1
- objectType2? int - Object type 2
- operationId? int - Operation type ID
- operationName? string - Operation name
- status? int - Operation status:
-
0- Success -
2- Error
-
- time string - Event timestamp
- userClient? string - Client
- userId int - Unique identifier for the user
- userIp? string - User IP
- userName? string - Username
dracoon.public: LogEventList
List of log events
Fields
- items LogEvent[] - List of log events
- range Range - Range information
dracoon.public: LoginPasswordPolicies
Login password policies
Fields
- characterRules CharacterRules - Password character rules
- minLength int - Minimum number of characters a password must contain
- numberOfArchivedPasswords int - Number of passwords to archive
(must be between
0and10;0means that password history is disabled)
- passwordExpiration PasswordExpiration - Password expiration information
- rejectDictionaryWords boolean - Determines whether a password must NOT contain word(s) from a dictionary
- rejectKeyboardPatterns boolean - Determines whether a password must NOT contain keyboard patterns (e.g.
qwertz,asdf) (min. 4 character pattern)
- rejectUserInfo boolean - Determines whether a password must NOT contain user info (first name, last name, email, user name)
- updatedAt string - Modification date
- updatedBy UserInfo - User information
- userLockout UserLockout - User lockout information
dracoon.public: LoginRequest
Request model for performing an authentication
Fields
- authType? string - Authentication methods
- language? string - Deprecated since v4.7.0 Language ID or ISO 639-1 code
- login? string - Deprecated since v4.7.0 User login name
- password string - Password
- state? string - For RADIUS Access-Challenge
If a
replyStateis returned, it must be included asstatein the following request.
- token? string - RADIUS Token
- userName? string - Since v4.13.0 Username
dracoon.public: LoginResponse
Authentication token
Fields
- token string - Authentication token
dracoon.public: LogOperation
Log operation
Fields
- id int - Operation type ID
- isDeprecated boolean - Determines whether log operation is deprecated or not
- name string - Operation name
dracoon.public: LogOperationList
List of log operations
Fields
- operationList LogOperation[] - List of all log operations
dracoon.public: MissingKeysResponse
Missing keys information
Fields
- files? FileFileKeys[] - List of file keys
- items? UserIdFileIdItem[] - List of user ID and file ID mappings
- range? Range - Range information
- users? UserUserPublicKey[] - List of user public keys
dracoon.public: MoveNode
Moved node information
Fields
- id int - Source node ID
- name? string - New node name
- timestampCreation? string - Since v4.22.0 Time the node was created on external file system (default: current server datetime in UTC format)
- timestampModification? string - Since v4.22.0 Time the content of a node was last modified on external file system (default: current server datetime in UTC format)
dracoon.public: MoveNodesRequest
Request model for moving nodes
Fields
- items? MoveNode[] - List of nodes to be moved
- nodeIds? int[] - Deprecated since v4.5.0
Node IDs
Please use
itemsinstead.
- resolutionStrategy? string - Node conflict resolution strategy:
-
autorename -
overwrite -
fail
-
dracoon.public: NewCustomerRequest
Request model for creating a customer
Fields
- activationCode? string - Deprecated since v4.8.0
Customer activation code string:
-
valid only for types
freeanddemo -
for
paycustomers it is empty
-
valid only for types
- companyName? string - Company name
- customerAttributes? CustomerAttributes - List of customer attributes
- customerContractType string - Customer type
- firstAdminUser FirstAdminUser - First administrator user
- isLocked boolean(default false) - Customer is locked:
-
false- unlocked -
true- locked
-
- lockStatus boolean(default false) - Deprecated since v4.7.0
Customer lock status:
-
false- unlocked -
true- locked
isLockedinstead. All users of this customer will be blocked and can not login anymore. -
- providerCustomerId? string - Provider customer ID
- quotaMax int - Maximal disc space which can be allocated by customer in bytes. -1 for unlimited
- trialDays? int - Number of days left for trial period (relevant only for type
demo) (not used)
- userMax int - Maximal number of users
- webhooksMax? int - Since v4.19.0 Maximal number of webhooks
dracoon.public: NewCustomerResponse
Customer information
Fields
- activationCode? string - Deprecated since v4.8.0
Customer activation code string:
-
valid only for types
freeanddemo -
for
paycustomers it is empty
-
valid only for types
- companyName string - Company name
- createdAt? string - Creation date
- customerAttributes? CustomerAttributes - List of customer attributes
- customerContractType string - Customer type
- customerUuid string - Since v4.21.0 Customer UUID
- firstAdminUser FirstAdminUser - First administrator user
- id? int - Unique identifier for the customer
- isLocked boolean(default false) - Customer is locked:
-
false- unlocked -
true- locked
-
- lockStatus boolean - Deprecated since v4.7.0
Customer lock status:
-
false- unlocked -
true- locked
isLockedinstead. All users of this customer will be blocked and can not login anymore. -
- providerCustomerId? string - Provider customer ID
- quotaMax int - Maximal disc space which can be allocated by customer in bytes. -1 for unlimited
- trialDays? int - Number of days left for trial period (relevant only for type
demo) (not used)
- userMax int - Maximal number of users
- webhooksMax? int - Since v4.19.0 Maximal number of webhooks
dracoon.public: Node
Node information (Node can be a room, folder or file)
Fields
- authParentId? int - Since v4.15.0 Auth parent room ID
- branchVersion? int - Version of last change in this node or a node further down the tree.
- children? Node[] - Deprecated since v4.10.0 Child nodes list (if requested) (for rooms / folders only)
- classification? int - Classification ID:
-
1- public -
2- internal -
3- confidential -
4- strictly confidential
-
- cntAdmins? int - Deprecated since v4.2.0 Number of admins (for rooms only)
- cntChildren? int - Deprecated since v4.11.0 Number of direct children (no recursion; for rooms / folders only)
- cntComments? int - Returns the number of comments of this node.
- cntDeletedVersions? int - Number of deleted versions of this file / folder (for rooms / folders only)
- cntFiles? int - Since v4.11.0 Amount of direct child files where this node is the parent node (no recursion; for rooms / folders only)
- cntFolders? int - Since v4.11.0 Amount of direct child folders where this node is the parent node (no recursion; for rooms / folders only)
- cntRooms? int - Since v4.11.0 Amount of direct child rooms where this node is the parent node (no recursion; for rooms only)
- cntUsers? int - Deprecated since v4.2.0 Number of users (for rooms only)
- createdAt? string - Creation date
- createdBy? UserInfo - User information
- encryptionInfo? EncryptionInfo - Encryption states
- expireAt? string - Expiration date
- fileType? string - File type / extension (for files only)
- hasActivitiesLog boolean(default true) - Is activities log active (for rooms only)
- hasRecycleBin? boolean - Deprecated since v4.10.0 Is recycle bin active (for rooms only) Recycle bin is always on (disabling is not possible).
- hash? string - MD5 hash of file
- id int - Node ID
- inheritPermissions? boolean - Inherit permissions from parent room
(default:
falseifparentIdis0; otherwise:true)
- isBrowsable? boolean - Since v4.11.0 Determines whether node is browsable by client (for rooms only)
- isEncrypted? boolean - Encryption state
- isFavorite? boolean - Node is marked as favorite (for rooms / folders only)
- mediaToken? string - Media server media token
- mediaType? string - File media type (for files only)
- name string - Name
- notes? string - User notes
- parentId? int - Parent node ID (room or folder)
- parentPath? string - Parent node path
/if node is a root node (room)
- permissions? NodePermissions - Node permissions
- quota? int - Quota in byte
- recycleBinRetentionPeriod? int - Retention period for deleted nodes in days
- size? int - Node size in byte
- timestampCreation? string - Since v4.22.0 Time the node was created on external file system
- timestampModification? string - Since v4.22.0 Time the content of a node was last modified on external file system
- 'type string - Node type
- updatedAt? string - Modification date
- updatedBy? UserInfo - User information
dracoon.public: NodeList
List of nodes
Fields
- items Node[] - List of nodes
- range Range - Range information
dracoon.public: NodeParent
Parent node
Fields
- id int - Node ID
- name string - Node name
- parentId? int - Parent node ID (room or folder)
- 'type string - Node type
dracoon.public: NodeParentList
List of parent nodes
Fields
- items? NodeParent[] - List of node parents
dracoon.public: NodePermissions
Node permissions
Fields
- change boolean - User / Group may update metadata of nodes: rename files and folders, change classification, etc.
- create boolean - User / Group may upload files, create folders and copy / move files to this room, overwriting is not possible.
- delete boolean - User / Group may overwrite and remove files / folders, move files from this room.
- deleteRecycleBin boolean - User / Group may permanently remove files / folders from the recycle bin.
- manage boolean - User / Group may grant all of the above permissions to other users and groups independently, may update room metadata and create / update / delete subordinary rooms, has all permissions.
- read boolean - User / Group may see all rooms, files and folders in the room and download everything, copy files from this room.
- readRecycleBin boolean - User / Group may look up files / folders in the recycle bin.
- restoreRecycleBin boolean - User / Group may restore files / folders from recycle bin - room permissions required.
dracoon.public: NotificationChannel
Notification channel information
Fields
- frequency int - Channel frequency (aggregation window size in minutes)
- id int - Channel ID
- isEnabled boolean - Determines whether channel is enabled
- name string - Name
- 'type string - Channel type (only
EMAILavailable at the moment)
dracoon.public: NotificationChannelActivationRequest
Request model for switching notification channel status
Fields
- channelId int - Channel ID
- isEnabled boolean - Determines whether channel is enabled
dracoon.public: NotificationChannelList
List of notification channels
Fields
- items NotificationChannel[] - List of notification channels
dracoon.public: NotificationConfig
Notification configuration information
Fields
- channelIds int[] - List of notification channel IDs
- eventTypeName string - Event type name
- id int - Notification configuration ID
- scopeId int - Scope ID
dracoon.public: NotificationConfigChangeRequest
Request model for updating notification configuration
Fields
- channelIds int[] - List of notification channel IDs. Leave empty to disable notifications.
dracoon.public: NotificationConfigList
List of notification configurations
Fields
- items NotificationConfig[] - List of notification configurations
dracoon.public: NotificationScope
Notification scope information
Fields
- id int - Scope ID
- name string - Name
dracoon.public: NotificationScopeList
List of notification scopes
Fields
- items NotificationScope[] - List of notification scopes
dracoon.public: OAuth2RefreshTokenGrantConfig
Closed record
OAuth2 Refresh Token Grant Configs
Fields
- Fields Included from *OAuth2RefreshTokenGrantConfig
- refreshUrl string(default "/oauth/token") - Refresh URL
dracoon.public: OAuthApproval
OAuth client approval information
Fields
- clientId string - ID of the OAuth client
- clientName string - Name, which is shown at the client configuration and authorization.
- expiresAt? string - Expiration date of the approval
dracoon.public: OAuthAuthorization
OAuth authorization
Fields
- clientId string - ID of the OAuth client
- clientName string - Name, which is shown at the client configuration and authorization.
- createdAt? string - Since v4.13.0 Creation date of the authorization
- expiresAt? string - Expiration date of the authorization
- id? int - Since v4.12.0 ID of the OAuth authorization
- isCurrentAuthorization? boolean - Since v4.25.0 Determines whether authorization matches the one from Authorization Header
- isStandard? boolean - Since v4.12.0 Determines whether client is a standard client.
- usedAt? string - Since v4.13.0 Usage date of the authorization (Time of last usage.)
- userAgentCategory string - Since v4.12.0 User agent category.
- userAgentInfo? string - Since v4.12.0 User agent info.
- userAgentOs? string - Since v4.12.0 User agent OS.
- userAgentType? string - Since v4.12.0 User agent type.
dracoon.public: OAuthClient
OAuth client information
Fields
- accessTokenValidity? int - Validity of the access token in seconds.
- approvalValidity? int - Since v4.22.0 Validity of the approval interval in seconds.
- clientId string - ID of the OAuth client
- clientName? string - Name, which is shown at the client configuration and authorization.
- clientSecret? string - Secret, which client uses at authentication.
- clientType? string - Determines whether client is a confidential or public client.
- isEnabled? boolean - Determines whether client is enabled.
- isExternal? boolean - Determines whether client is an external client.
- isStandard? boolean - Determines whether client is a standard client.
- redirectUris? string[] - URIs, to which a user is redirected after authorization.
- refreshTokenValidity? int - Validity of the refresh token in seconds.
dracoon.public: ObjectExpiration
Expiration information
Fields
- enableExpiration boolean - enabled / disabled
- expireAt? string - Expiration date
dracoon.public: OpenIdAuthInfo
List of OpenID Connect providers
Fields
- items OpenIdProvider[] - List of available OpenID Connect identity providers
dracoon.public: OpenIdAuthResources
List of OpenID Connect providers
Fields
- openIdProviders OpenIdProvider[] - List of available OpenID Connect identity providers
dracoon.public: OpenIdIdpConfig
OpenID Connect IDP configuration
Fields
- clientId? string - ID of the OpenID client
- clientSecret? string - Secret, which client uses at authentication.
- fallbackMappingClaim? string - Name of the claim which is used for the user mapping fallback.
- flow? string - Since v4.11.0 Flow, which is used at authentication
- id int - ID
- issuer? string - Issuer identifier of the IDP The value is a case sensitive URL.
- jwksEndPointUrl? string - URL of the JWKS endpoint
- mappingClaim? string - Name of the claim which is used for the user mapping.
- name? string - Name of the IDP
- redirectUris? string[] - URIs, to which a user is redirected after authorization.
- scopes? string[] - List of requested scopes
Usually
openidand the names of the requested claims.
- tokenEndPointUrl? string - URL of the token endpoint
- userImportEnabled boolean(default false) - Determines if a DRACOON account is automatically created for a new user who successfully logs on with his / her AD / IDP account.
- userImportGroup? int - User group that is assigned to users who are created by automatic import.
Reset with
0
- userInfoEndPointUrl? string - URL of the user info endpoint
- userInfoSource? string - Since v4.23.0 Source, which is used to get user information at the import or update of a user.
- userManagementUrl? string - URL of the user management UI. Use empty string to remove.
- userUpdateEnabled boolean(default false) - Determines if the DRACOON account is updated with data from AD / IDP.
For OpenID Connect, the scopes
emailandprofileare needed.
dracoon.public: OpenIdProvider
OpenID Connect provider information
Fields
- id int - ID
- isGlobalAvailable boolean - Is available for all customers
- issuer string - Issuer identifier of the IDP The value is a case sensitive URL.
- mappingClaim string - Name of the claim which is used for the user mapping.
- name string - Name of the IDP
- userManagementUrl? string - URL of the user management UI. Use empty string to remove.
dracoon.public: PasswordExpiration
Password expiration information
Fields
- enabled boolean - Determines whether password expiration is enabled
- maxPasswordAge? int - Maximum allowed password age (in days)
dracoon.public: PasswordPoliciesConfig
Set of password policies
Fields
- encryptionPasswordPolicies? EncryptionPasswordPolicies - Encryption password policies
- loginPasswordPolicies? LoginPasswordPolicies - Login password policies
dracoon.public: PasswordPolicyViolationResponse
List of violated password policies
Fields
- code int - HTTP status code
- debugInfo? string - Debug information
- errorCode? int - Internal error code
- message string - HTTP status code description
- violatedPasswordPolicies? ViolatedPasswordPolicy[] - List of violated password policies
dracoon.public: PendingAssignment
Pending assignment information
Fields
- groupId int - Unique identifier for the group
- roomId int - Room ID
- roomName string - Room name
- state string - Acceptance state:
-
ACCEPTED -
WAITING -
DENIED
-
- userId int - Unique identifier for the user
dracoon.public: PendingAssignmentData
Pending assignment information
Fields
- groupId? int - Deprecated since v4.2.0 Unique identifier for the group
- groupInfo GroupInfo - Group information
- pendingGroupData PendingGroupData - Pending group information
- pendingUserData PendingUserData - Pending user information
- roomId int - Room ID
- roomName string - Room name
- state string - Acceptance state:
-
ACCEPTED -
WAITING -
DENIED
-
- userId? int - Deprecated since v4.2.0 Unique identifier for the user
- userInfo UserInfo - User information
dracoon.public: PendingAssignmentList
List of pending assignments
Fields
- items PendingAssignmentData[] - List of pending assignment information
- range? Range - Range information
dracoon.public: PendingAssignmentsRequest
Request model for handling pending assignments
Fields
- items PendingAssignment[] - List of pending assignments
dracoon.public: PendingGroupData
Deprecated
Pending group information
Fields
- id int - Unique identifier for the group
use
idfromGroupInfoinstead
- name string - Group name
use
namefromGroupInfoinstead
Deprecated
dracoon.public: PendingUserData
Deprecated
Pending user information
Fields
- displayName string - Display name
use information from
UserInfoinstead to combine a display name
- email string - Email
use
emailfromUserInfoinstead
- id int - Unique identifier for the user
- login string - User login name
Deprecated
dracoon.public: PresignedUrl
Presigned URL information
Fields
- partNumber int - Corresponding part number
- url string - S3 presigned URL
dracoon.public: PresignedUrlList
List of generated presigned URLs
Fields
- urls PresignedUrl[] - List of S3 presigned URLs
dracoon.public: PrivateKeyContainer
Private key container
Fields
- createdAt? string - Since v4.24.0 Creation date
- createdBy? int - Since v4.24.0 Created by user
- expireAt? string - Expiration date
- privateKey string - Private key
- 'version string - Version
dracoon.public: ProfileAttributes
User profile attributes
Fields
- items KeyValueEntry[] - List of key-value pairs
- range Range - Range information
dracoon.public: ProfileAttributesRequest
Request model for setting user profile attributes
Fields
- items KeyValueEntry[] - List of key-value pairs
dracoon.public: 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
dracoon.public: PublicDownloadShare
Download Share information
Fields
- createdAt string - Creation date
- creatorName string - Creator name
- creatorUsername? string - Creator username
- expireAt? string - Expiration date
- fileKey? FileKey - File key information
- fileName string - File name
- hasDownloadLimit boolean - Since v4.11.0 Determines whether Download Share has a limit for amount of downloads
- isEncrypted? boolean - Encryption state
- isProtected boolean - Is share protected by password
- limitReached boolean - Downloads limit reached
- mediaType string - Since v4.11.0
-
application/zip(for folders and rooms) - actual file media type (for files only)
-
- name? string - Share display name (alias name)
- notes? string - User notes
- privateKeyContainer? PrivateKeyContainer - Private key container
- size int - File size or container size not compressed (in bytes)
dracoon.public: PublicDownloadTokenGenerateRequest
Request model for generating download URL
Fields
- password? string - Password (only for password-protected shares)
dracoon.public: PublicDownloadTokenGenerateResponse
Download URL
Fields
- downloadUrl? string - Download URL
- token string - Deprecated since v4.3.0 Download token
dracoon.public: PublicKeyContainer
Public key container
Fields
- createdAt? string - Since v4.24.0 Creation date
- createdBy? int - Since v4.24.0 Created by user
- expireAt? string - Expiration date
- publicKey string - Public key
- 'version string - Version
dracoon.public: PublicUploadedFileData
File information
Fields
- createdAt string - Creation date
- hash? string - Hash value of transferred file
- name string - Name
- size int - File size in byte
dracoon.public: PublicUploadShare
Upload Share information
Fields
- createdAt string - Creation date
- creatorName string - Since v4.11.0 Creator name
- creatorUsername? string - Since v4.11.0 Creator username
- expireAt? string - Expiration date
- isEncrypted? boolean - Encryption state
- isProtected boolean - Is share protected by password
- maxSize? decimal - Deprecated since v4.2.0 Maximal total size of uploaded files (in bytes)
- maxSlots int - Deprecated since v4.2.0 Maximal amount of files to upload
- name? string - Share display name (alias name)
- notes? string - User notes
- remainingSize? int - Remaining size
- remainingSlots? int - Remaining slots
- showUploadedFiles? boolean - Allow display of already uploaded files
- uploadedFiles? PublicUploadedFileData[] - List of (public) uploaded files
- userUserPublicKeyList? UserUserPublicKeyList - List of user public keys
dracoon.public: RadiusChallengeResponse
RADIUS challenge reply
Fields
- code int - HTTP status code
- debugInfo? string - Debug information
- errorCode? int - Internal error code
- message string - HTTP status code description
- replyMessage string - RADIUS Reply-Message Instruction how to handle the situation.
- replyState string - For RADIUS Access-Challenge
If a
replyStateis returned, it must be included asstatein the following request.
dracoon.public: RadiusConfig
RADIUS configuration
Fields
- failoverServer? FailoverServer - Failover server information
- ipAddress string - RADIUS Server IP Address
- otpPinFirst boolean - Sequence order of concatenated PIN and one-time token
- port int - RADIUS Server Port
dracoon.public: RadiusConfigCreateRequest
Request model for creating a RADIUS configuration
Fields
- failoverServer? FailoverServer - Failover server information
- ipAddress string - RADIUS Server IP Address
- otpPinFirst boolean(default true) - Sequence order of concatenated PIN and one-time token
- port int - RADIUS Server Port
dracoon.public: RadiusConfigUpdateRequest
Request model for updating a RADIUS configuration
Fields
- failoverServer? FailoverServer - Failover server information
- ipAddress? string - RADIUS Server IP Address
- otpPinFirst? boolean - Sequence order of concatenated PIN and one-time token
- port? int - RADIUS Server Port
dracoon.public: Range
Range information
Fields
- 'limit int - Range limit. Maximum 500.
- offset int - Range offset
- total int - Total items available
dracoon.public: RecoverUserNameRequest
Recover usernames for email
Fields
- creatorLanguage? string - IETF language tag
- email string - Email
dracoon.public: ResetPasswordRequest
Request model for reseting user's login password
Fields
- creatorLanguage? string - IETF language tag
- language? string - Deprecated since v4.7.0 Language ID or ISO 639-1 code
- login? string - Deprecated since v4.13.0 User login name
- userName? string - Since v4.13.0 Username
dracoon.public: ResetPasswordTokenValidateResponse
Password reset information
Fields
- allowSystemGlobalWeakPassword? boolean - Deprecated since v4.14.0
Allow weak password
Please use
loginPasswordPoliciesinstead
- firstName string - User first name
- gender string(default "n") - Deprecated since v4.12.0 Gender
- lastName string - User last name
- loginPasswordPolicies? LoginPasswordPolicies - Login password policies
- title? string - Deprecated since v4.18.0 Job title
dracoon.public: ResetPasswordWithTokenRequest
New password
Fields
- password string - New password
dracoon.public: RestoreDeletedNodesRequest
Request model for restoring deleted nodes
Fields
- deletedNodeIds int[] - List of deleted node IDs
- parentId? int - Node parent ID (default: previous parent ID)
- resolutionStrategy string(default "autorename") - Node conflict resolution strategy:
-
autorename -
overwrite -
fail
-
dracoon.public: Right
Right information
Fields
- description string - Right description
- id int - Unique identifier for the right
- name string - Right (unique) name
dracoon.public: Role
Role information
Fields
- description string - Role description
- id int - Unique identifier for the role
- items? Right[] - List of reachable right over role
- name string - Role (unique) name
dracoon.public: RoleGroup
Group information
Fields
- id int - Unique identifier for the group
- isMember boolean - Is group member of the role
- name string - Group name
dracoon.public: RoleGroupList
List of groups with assigned role
Fields
- items RoleGroup[] - List of role-group mappings
- range Range - Range information
dracoon.public: RoleList
List of roles
Fields
- items Role[] - List of roles
dracoon.public: RoleUser
User information
Fields
- displayName string - Deprecated since v4.11.0
Display name
use information from
UserInfoinstead to combine a display name
- id int - Deprecated since v4.11.0
Unique identifier for the user
use
idfromUserInfoinstead
- isMember boolean - Is user member of the role
- userInfo UserInfo - User information
dracoon.public: RoleUserList
List of users with assigned role
Fields
- items RoleUser[] - List of role-user mappings
- range Range - Range information
dracoon.public: RoomData
Room information
Fields
- children? RoomData[] - Deprecated since v4.10.0 List of rooms, where this room is a parent (if exist)
- cntAdmins? int - Deprecated since v4.2.0 Number of admins (for rooms only)
- cntUsers? int - Deprecated since v4.2.0 Number of users (for rooms only)
- createdAt? string - Expiration date
- createdBy? UserInfo - User information
- hasRecycleBin boolean - Deprecated since v4.10.0 Is recycle bin active (for rooms only) Recycle bin is always on (disabling is not possible).
- id int - Room ID
- isEncrypted boolean - Encryption state
- isFavorite? boolean - Node is marked as favorite (for rooms / folders only)
- isGranted boolean - Is user granted room permissions
- name string - Name
- parentId? int - Parent node ID (room or folder)
- permissions? NodePermissions - Node permissions
- quota? int - Quota in byte
- recycleBinRetentionPeriod int - Retention period for deleted nodes in days
- size? int - Room size
- 'type? string - Node type
- updatedAt? string - Modification date
- updatedBy? UserInfo - User information
dracoon.public: RoomGroup
Group information
Fields
- id int - Unique identifier for the group
- isGranted boolean - Is user granted room permissions
- name string - Group name
- newGroupMemberAcceptance string(default "autoallow") - Behaviour when new users are added to the group:
-
autoallow -
pending
adminGroupIdshas items. -
- permissions? NodePermissions - Node permissions
dracoon.public: RoomGroupList
List of groups
Fields
- items RoomGroup[] - List of room-group mappings
- range Range - Range information
dracoon.public: RoomGroupsAddBatchRequest
Request model for granting group(s) to the room
Fields
- items RoomGroupsAddBatchRequestItem[] - List of room-group mappings
dracoon.public: RoomGroupsAddBatchRequestItem
Request item model for granting group to the room
Fields
- id int - Unique identifier for the group
- newGroupMemberAcceptance string(default "autoallow") - Behaviour when new users are added to the group:
-
autoallow -
pending
adminGroupIdshas items. -
- permissions NodePermissions - Node permissions
dracoon.public: RoomGroupsDeleteBatchRequest
Request model for revoking group(s) from the room
Fields
- ids int[] - List of group IDs
dracoon.public: RoomTreeDataList
List of rooms
Fields
- items RoomData[] - List of room data information
- range Range - Range information
dracoon.public: RoomUser
User information
Fields
- displayName string - Deprecated since v4.11.0
Display name
use information from
UserInfoinstead to combine a display name
- email string - Deprecated since v4.11.0
Email
use
emailfromUserInfoinstead
- id int - Deprecated since v4.11.0
Unique identifier for the user
use
idfromUserInfoinstead
- isGranted boolean - Is user granted room permissions
- login string - Deprecated since v4.11.0 User login name
- permissions? NodePermissions - Node permissions
- publicKeyContainer? PublicKeyContainer - Public key container
- userInfo UserInfo - User information
dracoon.public: RoomUserList
List of users
Fields
- items RoomUser[] - List of room-user mappings
- range Range - Range information
dracoon.public: RoomUsersAddBatchRequest
Request model for granting user(s) to the room
Fields
- items RoomUsersAddBatchRequestItem[] - List of room-user mappings
dracoon.public: RoomUsersAddBatchRequestItem
Request item model for granting user to the room
Fields
- id int - Unique identifier for the user
- permissions NodePermissions - Node permissions
dracoon.public: RoomUsersDeleteBatchRequest
Request model for revoking user(s) from the room
Fields
- ids int[] - List of user IDs
dracoon.public: RoomWebhook
Webhook information
Fields
- isAssigned boolean - Determines whether webhook is assigned to the room.
- webhook Webhook - Webhook information
dracoon.public: RoomWebhookAssignment
Request model for handling webhook assignments
Fields
- isAssigned boolean - Determines whether webhook is assigned to the room.
- webhookId int - Webhook ID
dracoon.public: RoomWebhookList
List of webhooks
Fields
- items RoomWebhook[] - List of webhooks
- range Range - Range information
dracoon.public: S3Config
S3 configuration
Fields
- accessKeyDefined boolean - Determines whether Access Key ID is defined
- bucketName? string - Deprecated since v4.24.0
S3 bucket name
use
bucketUrlinstead
- bucketUrl string - S3 object storage bucket URL
- endpointUrl? string - Deprecated since v4.24.0
S3 object storage endpoint URL
use
bucketUrlinstead
- region? string - S3 region
- secretKeyDefined boolean - Determines whether Access Secret Key is defined
dracoon.public: S3ConfigCreateRequest
Request model for creating a S3 configuration
Fields
- accessKey string - Access Key ID
- bucketName? string - Deprecated since v4.24.0
S3 bucket name
use
bucketUrlinstead
- bucketUrl? string - S3 object storage bucket URL
- endpointUrl? string - Deprecated since v4.24.0
S3 object storage endpoint URL
use
bucketUrlinstead
- region? string - S3 region
- secretKey string - Secret Access Key
dracoon.public: S3ConfigUpdateRequest
Request model for updating a S3 configuration
Fields
- accessKey? string - Access Key ID
- bucketName? string - Deprecated since v4.24.0
S3 bucket name
use
bucketUrlinstead
- bucketUrl? string - S3 object storage bucket URL
- endpointUrl? string - Deprecated since v4.24.0
S3 object storage endpoint URL
use
bucketUrlinstead
- region? string - S3 region
- secretKey? string - Secret Access Key
dracoon.public: S3FileUploadPart
S3 file upload part information
Fields
- partEtag string - Corresponding part ETag
- partNumber int - Corresponding part number
dracoon.public: S3FileUploadStatus
S3 file upload status information
Fields
- errorDetails? ErrorResponse - Error information
- node? Node - Node information (Node can be a room, folder or file)
- status string - S3 file upload status:
-
transfer- upload in progress -
finishing- completing file upload -
done- file upload successully done -
error- an error occurred while file upload
-
dracoon.public: S3ShareUploadStatus
S3 file upload status information
Fields
- errorDetails? ErrorResponse - Error information
- fileName string - File name
- size? int - File size in byte
- status string - S3 file upload status:
-
transfer- upload in progress -
finishing- completing file upload -
done- file upload successully done -
error- an error occurred while file upload
-
dracoon.public: S3Tag
S3 tag information
Fields
- id? int - S3 tag ID
- isMandatory? boolean - Determines whether S3 is mandatory or not
- 'key? string - S3 tag key
- value? string - S3 tag value
dracoon.public: S3TagCreateRequest
Request model for creating a S3 tag
Fields
- isMandatory boolean(default false) - Determines whether S3 is mandatory or not
- 'key string - S3 tag key
- value string - S3 tag value
dracoon.public: S3TagIds
List of S3 tag IDs
Fields
- ids int[] - List of S3 tag IDs
dracoon.public: S3TagList
List of S3 tags
Fields
- items? S3Tag[] - List of configured S3 tags
dracoon.public: SdsServerTime
DRACOON server time
Fields
- time? string - DRACOON server time
dracoon.public: SharesPasswordPolicies
Shares password policies
Fields
- characterRules? CharacterRules - Password character rules
- minLength? int - Minimum number of characters a password must contain
- rejectDictionaryWords? boolean - Determines whether a password must NOT contain word(s) from a dictionary
- rejectKeyboardPatterns? boolean - Determines whether a password must NOT contain keyboard patterns (e.g.
qwertz,asdf) (min. 4 character pattern)
- rejectUserInfo? boolean - Determines whether a password must NOT contain user info (first name, last name, email, user name)
- updatedAt? string - Modification date
- updatedBy? UserInfo - User information
dracoon.public: SoftwareVersionData
Software version information
Fields
- buildDate string - Build date
- isDracoonCloud? boolean - Since v4.24.0 Determines if the DRACOON Core is deployed in the cloud environment
- restApiVersion string - REST API version
- scmRevisionNumber string - Revision number
- sdsServerVersion string - DRACOON server version
dracoon.public: SubscribedDownloadShare
Subscribed download share information
Fields
- authParentId? int - Auth parent room ID
- id int - Share ID
dracoon.public: SubscribedDownloadShareList
List of subscribed download shares
Fields
- items SubscribedDownloadShare[] - List of subscribed download shares
- range Range - Range information
dracoon.public: SubscribedNode
Subscribed node information
Fields
- authParentId? int - Auth parent room ID
- id int - Node ID
- 'type? string - Node type
dracoon.public: SubscribedNodeList
List of subscribed nodes
Fields
- items SubscribedNode[] - List of subscribed nodes
- range Range - Range information
dracoon.public: SubscribedUploadShare
Subscribed upload share information
Fields
- id int - Share ID
- targetNodeId? int - Target room or folder ID
dracoon.public: SubscribedUploadShareList
List of subscribed upload shares
Fields
- items SubscribedUploadShare[] - List of subscribed upload shares
- range Range - Range information
dracoon.public: SyslogConfig
Syslog settings
Fields
- enabled? boolean - Is syslog enabled?
- host? string - Syslog server (IP or FQDN)
- logIpEnabled? boolean - Determines whether user’s IP address is logged.
- port? int - Syslog server port
- protocol? string - Protocol to connect to syslog server
dracoon.public: SyslogEvent
Deprecated
Syslog event information
Fields
- attribute1? string - Attribute 1
- attribute2? string - Attribute 2
- attribute3? string - Attribute 3
- authParentSource? string - Auth parent source ID
- authParentTarget? string - Auth parent target ID
- customerId? int - Unique identifier for the customer
- id int - Event ID
- message string - Event description
- objectId1? int - Object ID 1
- objectId2? int - Object ID 2
- objectName1? string - Object name 1
- objectName2? string - Object type 2
- objectType1? int - Object type 1
- objectType2? int - Object type 2
- operationId? int - Operation type ID
- operationName? string - Operation name
- status? int - Operation status:
-
0- Success -
2- Error
-
- time string - Event timestamp
- userClient? string - Client
- userId int - Unique identifier for the user
- userIp? string - User IP
- userName? string - Username
Deprecated
dracoon.public: SyslogEventList
Deprecated
List of syslog events
Fields
- items SyslogEvent[] - List of log events
- range Range - Range information
Deprecated
dracoon.public: SystemDefaults
System defaults
Fields
- fileDefaultExpirationPeriod? int - Default expiration period for all uploaded files in days.
- hideLoginInputFields? boolean - Since v4.13.0 Defines if login fields should be hidden
- languageDefault? string - Define which language should be default.
- nonmemberViewerDefault? boolean - Since v4.12.0 Defines if new users get the role Non Member Viewer by default
dracoon.public: SystemInfo
System information (default language and authentication methods)
Fields
- authMethods AuthMethod[] - Deprecated since v4.13.0
Authentication methods:
-
sql -
active_directory -
radius -
openid
authDatainstead -
- hideLoginInputFields boolean - Since v4.13.0 Defines if login fields should be hidden
- s3EnforceDirectUpload boolean - Since v4.15.0 Determines whether S3 direct upload is enforced or not
- s3Hosts string[] - Since v4.14.0 List of S3 Hosts for CSP header
- useS3Storage boolean - Since v4.21.0 Defines if S3 is used as storage backend
dracoon.public: TestActiveDirectoryConfigRequest
Request model for testing connection for Active Directory configuration
Fields
- ldapUsersDomain string - Search scope of Active Directory; only users below this node can log on.
- serverAdminName string - Distinguished Name (DN) of Active Directory administrative account
- serverAdminPassword string - Password of Active Directory administrative account
- serverIp string - IPv4 or IPv6 address or host name
- serverPort int - Port
- sslFingerPrint? string - SSL finger print of Active Directory server.
Mandatory for LDAPS connections.
Format:
Algorithm/Fingerprint
- useLdaps boolean(default false) - Determines whether LDAPS should be used instead of plain LDAP.
dracoon.public: TestActiveDirectoryConfigResponse
Response model for testing connection for Active Directory configuration
Fields
- ldapUsersDomain string - Search scope of Active Directory; only users below this node can log on.
- serverAdminName string - Distinguished Name (DN) of Active Directory administrative account
- serverAdminPassword string - Password of Active Directory administrative account
- serverIp string - IPv4 or IPv6 address or host name
- serverPort int - Port
- sslFingerPrint? string - SSL finger print of Active Directory server.
Mandatory for LDAPS connections.
Format:
Algorithm/Fingerprint
- useLdaps boolean - Determines whether LDAPS should be used instead of plain LDAP.
dracoon.public: ThirdPartyDependenciesData
Third-party dependency information
Fields
- artifactId string - Third party dependencies artifactId
- description string - Third party dependencies description
- groupId string - Third party dependencies groupId
- id string - Third party dependencies id
- licenses string[] - Third party dependencies licenses type
- name string - Third party dependencies name
- 'type string - Third party dependencies type
- url string - Third party dependencies url
- 'version string - Third party dependencies version
dracoon.public: UpdateActiveDirectoryConfigRequest
Request model for updating an Active Directory configuration
Fields
- adExportGroup? string - If
userImportis set totrue, the user must be member of this Active Directory group to receive a newly created DRACOON account.
- alias? string - Unique name for an Active Directory configuration
- createHomeFolder? boolean - DEPRECATED, will be ignored Determines whether a room is created for each user that is created by automatic import (like a home folder). Room's name will equal the user's login name.
- homeFolderParent? int - DEPRECATED, will be ignored ID of the room in which the individual rooms for users will be created.
- ldapUsersDomain? string - Search scope of Active Directory; only users below this node can log on.
- sdsImportGroup? int - User group that is assigned to users who are created by automatic import.
Reset with
0
- serverAdminName? string - Distinguished Name (DN) of Active Directory administrative account
- serverAdminPassword? string - Password of Active Directory administrative account
- serverIp? string - IPv4 or IPv6 address or host name
- serverPort? int - Port
- sslFingerPrint? string - SSL finger print of Active Directory server.
Mandatory for LDAPS connections.
Format:
Algorithm/Fingerprint
- useLdaps? boolean - Determines whether LDAPS should be used instead of plain LDAP.
- userFilter? string - Name of Active Directory attribute that is used as login name.
- userImport? boolean - Determines if a DRACOON account is automatically created for a new user who successfully logs on with his / her AD / IDP account.
dracoon.public: UpdateAuthTokenRestrictions
Request model for updating auth token settings
Fields
- accessTokenValidity? int - Since v4.13.0 Restricted OAuth access token validity (in seconds)
- overwriteEnabled boolean - Since v4.13.0 Defines if OAuth token restrictions are enabled
- refreshTokenValidity? int - Since v4.13.0 Restricted OAuth refresh token validity (in seconds)
dracoon.public: UpdateCustomerRequest
Request model for updating a customer
Fields
- companyName? string - Company name
- customerContractType string - Customer type
- isLocked boolean(default false) - Customer is locked:
-
false- unlocked -
true- locked
-
- lockStatus boolean(default false) - Deprecated since v4.7.0
Customer lock status:
-
false- unlocked -
true- locked
isLockedinstead. All users of this customer will be blocked and can not login anymore. -
- providerCustomerId? string - Provider customer ID
- quotaMax? int - Maximal disc space which can be allocated by customer in bytes. -1 for unlimited
- userMax? int - Maximal number of users
- webhooksMax? int - Since v4.19.0 Maximal number of webhooks
dracoon.public: UpdateCustomerResponse
Customer information
Fields
- activationCode? string - Deprecated since v4.8.0
Customer activation code string:
-
valid only for types
freeanddemo -
for
paycustomers it is empty
-
valid only for types
- companyName string - Company name
- createdAt? string - Creation date
- customerAttributes? CustomerAttributes - List of customer attributes
- customerContractType string - Customer type
- customerUuid string - Since v4.21.0 Customer UUID
- id int - Unique identifier for the customer
- isLocked boolean(default false) - Customer is locked:
-
false- unlocked -
true- locked
-
- lockStatus boolean - Deprecated since v4.7.0
Customer lock status:
-
false- unlocked -
true- locked
isLockedinstead. All users of this customer will be blocked and can not login anymore. -
- providerCustomerId? string - Provider customer ID
- quotaMax int - Maximal disc space which can be allocated by customer in bytes. -1 for unlimited
- trialDays? int - Number of days left for trial period (relevant only for type
demo) (not used)
- updatedAt? string - Modification date
- userMax int - Maximal number of users
- webhooksMax? int - Since v4.19.0 Maximal number of webhooks
dracoon.public: UpdateDownloadShareRequest
Request model for updating a Download Share
Fields
- defaultCountry? string - Country shorthand symbol (cf. ISO 3166-2)
- expiration? ObjectExpiration - Expiration information
- internalNotes? string - Since v4.11.0 Internal notes
- maxDownloads? int - Max allowed downloads
- name? string - Alias name
- notes? string - User notes
- notifyCreator? boolean - Deprecated since v4.20.0 Notify creator on every download.
- password? string - Access password, not allowed for encrypted shares
- receiverLanguage? string - Language tag for messages to receiver
- resetMaxDownloads? boolean - Set 'true' to reset 'maxDownloads' for Download Share.
- resetPassword? boolean - Set 'true' to reset 'password' for Download Share.
- showCreatorName? boolean - Show creator first and last name.
- showCreatorUsername? boolean - Show creator email address.
- textMessageRecipients? string[] - List of recipient FQTNs E.123 / E.164 Format
dracoon.public: UpdateDownloadSharesBulkRequest
Request model for updating a list of Download Shares
Fields
- expiration? ObjectExpiration - Expiration information
- maxDownloads? int - Max allowed downloads
- objectIds int[] - List of ids
- resetMaxDownloads? boolean - Set 'true' to reset 'maxDownloads' for Download Share.
- showCreatorName? boolean - Show creator first and last name.
- showCreatorUsername? boolean - Show creator email address.
dracoon.public: UpdateEncryptionPasswordPolicies
Request model for updating encryption password policies
Fields
- characterRules? CharacterRules - Password character rules
- minLength? int - Minimum number of characters a password must contain
- rejectKeyboardPatterns? boolean - Determines whether a password must NOT contain keyboard patterns (e.g.
qwertz,asdf) (min. 4 character pattern)
- rejectUserInfo? boolean - Determines whether a password must NOT contain user info (first name, last name, email, user name)
dracoon.public: UpdateEventlogConfig
Request model for updating eventlog settings
Fields
- enabled? boolean - Is eventlog enabled?
- logIpEnabled? boolean - Determines whether user’s IP address is logged.
- retentionPeriod? int - Retention period (in days) of event log entries. After that period, all entries are deleted. Recommended value: 7
dracoon.public: UpdateFavoritesBulkRequest
Request model for updating favorites
Fields
- isFavorite boolean - Sets the favorite attribute to true or false on each file in an array of nodes.
- objectIds int[] - List of ids
dracoon.public: UpdateFileRequest
Request model for updating file's metadata
Fields
- classification? int - Classification ID:
-
1- public -
2- internal -
3- confidential -
4- strictly confidential
-
- expiration? ObjectExpiration - Expiration information
- name? string - File name
- notes? string - User notes Use empty string to remove.
- timestampCreation? string - Since v4.22.0 Time the node was created on external file system (default: current server datetime in UTC format)
- timestampModification? string - Since v4.22.0 Time the content of a node was last modified on external file system (default: current server datetime in UTC format)
dracoon.public: UpdateFilesBulkRequest
Request model for updating files
Fields
- classification? int - Classification ID:
-
1- public -
2- internal -
3- confidential -
4- strictly confidential
-
- expiration? ObjectExpiration - Expiration information
- objectIds int[] - List of ids
dracoon.public: UpdateFolderRequest
Request model for updating folder's metadata
Fields
- name? string - Folder name
- notes? string - User notes Use empty string to remove.
- timestampCreation? string - Since v4.22.0 Time the node was created on external file system (default: current server datetime in UTC format)
- timestampModification? string - Since v4.22.0 Time the content of a node was last modified on external file system (default: current server datetime in UTC format)
dracoon.public: UpdateGeneralSettings
Request model for updating general settings
Fields
- authTokenRestrictions? UpdateAuthTokenRestrictions - Request model for updating auth token settings
- cryptoEnabled? boolean - Activation status of client-side encryption. Can only be enabled once; disabling is not possible.
- emailNotificationButtonEnabled? boolean - Enable email notification button
- eulaEnabled? boolean - Each user has to confirm the EULA at first login.
- hideLoginInputFields? boolean - Deprecated since v4.13.0 Defines if login fields should be hidden
- mediaServerEnabled? boolean - Deprecated since v4.12.0 Determines if the media server is enabled
- s3TagsEnabled? boolean - Since v4.9.0 Defines if S3 tags are enabled
- weakPasswordEnabled? boolean - Deprecated since v4.14.0
Allow weak password
- A weak password has to fulfill the following criteria:
- is at least 8 characters long
- contains letters and numbers
- A strong password has to fulfill the following criteria in addition:
- contains at least one special character
- contains upper and lower case characters
PUT /system/config/policies/passwordsAPI to change configured password policies.
dracoon.public: UpdateGroupRequest
Request model for updating group's metadata
Fields
- expiration? ObjectExpiration - Expiration information
- name? string - Group name
dracoon.public: UpdateLoginPasswordPolicies
Request model for updating login password policies
Fields
- characterRules? CharacterRules - Password character rules
- enforceLoginPasswordChange? boolean - Deprecated since v4.24.0 Determines whether a login password change should be enforced for all users Only takes effect, if login password policies get stricter
- minLength? int - Minimum number of characters a password must contain
- numberOfArchivedPasswords? int - Number of passwords to archive
(must be between
0and10;0means that password history is disabled)
- passwordExpiration? PasswordExpiration - Password expiration information
- rejectDictionaryWords? boolean - Determines whether a password must NOT contain word(s) from a dictionary
- rejectKeyboardPatterns? boolean - Determines whether a password must NOT contain keyboard patterns (e.g.
qwertz,asdf) (min. 4 character pattern)
- rejectUserInfo? boolean - Determines whether a password must NOT contain user info (first name, last name, email, user name)
- userLockout? UserLockout - User lockout information
dracoon.public: UpdateOAuthClientRequest
Request model for updating an OAuth client
Fields
- accessTokenValidity? int - Validity of the access token in seconds.
- approvalValidity? int - Since v4.22.0 Validity of the approval interval in seconds.
- clientName? string - Name, which is shown at the client configuration and authorization.
- clientSecret? string - Secret, which client uses at authentication.
- clientType? string - Determines whether client is a confidential or public client.
- isEnabled? boolean - Determines whether client is enabled.
- redirectUris? string[] - URIs, to which a user is redirected after authorization.
- refreshTokenValidity? int - Validity of the refresh token in seconds.
dracoon.public: UpdateOpenIdIdpConfigRequest
Request model for updating an OpenID Connect IDP configuration
Fields
- clientId? string - ID of the OpenID client
- clientSecret? string - Secret, which client uses at authentication.
- fallbackMappingClaim? string - Name of the claim which is used for the user mapping fallback.
- flow? string - Since v4.11.0 Flow, which is used at authentication
- issuer? string - Issuer identifier of the IDP The value is a case sensitive URL.
- jwksEndPointUrl? string - URL of the JWKS endpoint
- mappingClaim? string - Name of the claim which is used for the user mapping.
- name? string - Name of the IDP
- redirectUris? string[] - URIs, to which a user is redirected after authorization.
- resetFallbackMappingClaim? boolean - Set
trueto resetfallbackMappingClaim.
- scopes? string[] - List of requested scopes
Usually
openidand the names of the requested claims.
- tokenEndPointUrl? string - URL of the token endpoint
- userImportEnabled? boolean - Determines if a DRACOON account is automatically created for a new user who successfully logs on with his / her AD / IDP account.
- userImportGroup? int - User group that is assigned to users who are created by automatic import.
Reset with
0
- userInfoEndPointUrl? string - URL of the user info endpoint
- userInfoSource? string - Since v4.23.0 Source, which is used to get user information at the import or update of a user.
- userManagementUrl? string - URL of the user management UI. Use empty string to remove.
- userUpdateEnabled? boolean - Determines if the DRACOON account is updated with data from AD / IDP.
For OpenID Connect, the scopes
emailandprofileare needed.
dracoon.public: UpdatePasswordPoliciesConfig
Request model for updating a set of password policies
Fields
- encryptionPasswordPolicies? UpdateEncryptionPasswordPolicies - Request model for updating encryption password policies
- loginPasswordPolicies? UpdateLoginPasswordPolicies - Request model for updating login password policies
dracoon.public: UpdateRoomRequest
Request model for updating room's metadata
Fields
- name? string - Name
- notes? string - User notes Use empty string to remove.
- quota? int - Quota in byte
- timestampCreation? string - Since v4.22.0 Time the node was created on external file system
- timestampModification? string - Since v4.22.0 Time the content of a node was last modified on external file system
dracoon.public: UpdateRoomWebhookRequest
Request model for handling webhook assignments
Fields
- items RoomWebhookAssignment[] - Assign a webhook to a room to use it for node actions within the room
dracoon.public: UpdateSharesPasswordPolicies
Request model for updating shares password policies
Fields
- characterRules? CharacterRules - Password character rules
- minLength? int - Minimum number of characters a password must contain
- rejectDictionaryWords? boolean - Determines whether a password must NOT contain word(s) from a dictionary
- rejectKeyboardPatterns? boolean - Determines whether a password must NOT contain keyboard patterns (e.g.
qwertz,asdf) (min. 4 character pattern)
- rejectUserInfo? boolean - Determines whether a password must NOT contain user info (first name, last name, email, user name)
dracoon.public: UpdateSubscriptionsBulkRequest
Request model for updating subscriptions
Fields
- isSubscribed boolean - Creates or deletes a subscription on each item in an array of objects.
- objectIds int[] - List of ids
dracoon.public: UpdateSyslogConfig
Request model for updating syslog settings
Fields
- enabled? boolean - Is syslog enabled?
- host? string - Syslog server (IP or FQDN)
- logIpEnabled? boolean - Determines whether user’s IP address is logged.
- port? int - Syslog server port
- protocol? string - Protocol to connect to syslog server
dracoon.public: UpdateSystemDefaults
Request model for updating system defaults
Fields
- fileDefaultExpirationPeriod? int - Default expiration period for all uploaded files in days.
- languageDefault? string - Define which language should be default.
- nonmemberViewerDefault? boolean - Since v4.12.0 Defines if new users get the role Non Member Viewer by default
dracoon.public: UpdateUploadShareRequest
Request model for updating an Upload Share
Fields
- defaultCountry? string - Country shorthand symbol (cf. ISO 3166-2)
- expiration? ObjectExpiration - Expiration information
- filesExpiryPeriod? int - Number of days after which uploaded files expire
- internalNotes? string - Since v4.11.0 Internal notes
- maxSize? int - Maximal total size of uploaded files (in bytes)
- maxSlots? int - Maximal amount of files to upload
- name? string - Alias name
- notes? string - User notes
- notifyCreator? boolean - Deprecated since v4.20.0 Notify creator on every upload.
- password? string - Password
- receiverLanguage? string - Language tag for messages to receiver
- resetFilesExpiryPeriod? boolean - Set 'true' to reset 'filesExpiryPeriod' for Upload Share
- resetMaxSize? boolean - Set 'true' to reset 'maxSize' for Upload Share
- resetMaxSlots? boolean - Set 'true' to reset 'maxSlots' for Upload Share
- resetPassword? boolean - Set 'true' to reset 'password' for Upload Share.
- showCreatorName? boolean - Show creator first and last name.
- showCreatorUsername? boolean - Show creator email address.
- showUploadedFiles? boolean - Allow display of already uploaded files
- textMessageRecipients? string[] - List of recipient FQTNs E.123 / E.164 Format
dracoon.public: UpdateUploadSharesBulkRequest
Request model for updating a list of Download Shares
Fields
- expiration? ObjectExpiration - Expiration information
- filesExpiryPeriod? int - Number of days after which uploaded files expire
- maxSize? int - Maximal total size of uploaded files (in bytes)
- maxSlots? int - Maximal amount of files to upload
- objectIds int[] - List of ids
- resetFilesExpiryPeriod? boolean - Set 'true' to reset 'filesExpiryPeriod' for Upload Share
- resetMaxSize? boolean - Set 'true' to reset 'maxSize' for Upload Share
- resetMaxSlots? boolean - Set 'true' to reset 'maxSlots' for Upload Share
- showCreatorName? boolean - Show creator first and last name.
- showCreatorUsername? boolean - Show creator email address.
- showUploadedFiles? boolean - Allow display of already uploaded files
dracoon.public: UpdateUserAccountRequest
Request model for updating user account information
Fields
- acceptEULA? boolean - Accept EULA
Present, if EULA is system global active.
cf.
GET system/config/settings/general-eulaEnabledIf accepted can not be undone.
- email? string - Email
- firstName? string - User first name
- gender? string - Deprecated since v4.12.0
Gender
Do NOT use
gender! It will be ignored.
- language? string - Since v4.20.0 IETF language tag
- lastName? string - User last name
- login? string - Deprecated since v4.13.0 User login name
- phone? string - Phone number
- title? string - Deprecated since v4.18.0 Job title
- userName? string - Since v4.13.0 Username
dracoon.public: UpdateUserRequest
Request model for updating user's metadata
Fields
- authData? UserAuthDataUpdateRequest - User Authentication Data Update Request
- authMethods? UserAuthMethod[] - Deprecated since v4.13.0
Authentication methods:
-
sql -
active_directory -
radius -
openid
authDatainstead -
- email? string - Email
- expiration? ObjectExpiration - Expiration information
- firstName? string - User first name
- gender? string - Deprecated since v4.12.0
Gender
Do NOT use
gender! It will be ignored.
- isLocked? boolean - User is locked:
-
false- unlocked -
true- locked
-
- lastName? string - User last name
- lockStatus? int - Deprecated since v4.7.0
User lock status:
-
0- locked -
1- Web access allowed -
2- Web and mobile access allowed
isLockedinstead. -
- phone? string - Phone number
- receiverLanguage? string - IETF language tag
- title? string - Deprecated since v4.18.0 Job title
- userName? string - Since v4.13.0 Username
dracoon.public: UpdateWebhookRequest
Request model for updating a webhook
Fields
- eventTypeNames? string[] - List of names of event types
- isEnabled? boolean - Is enabled
- name? string - Name
- secret? string - Secret; used for event message signatures
- triggerExampleEvent? boolean - If set to true, an example event is being created
- url? string - URL (must begin with the
HTTPSscheme)
dracoon.public: UploadShare
Upload Share information
Fields
- accessKey string - Share access key to generate secure link
- cntFiles? int - Total amount of existing files uploaded with this share.
- cntUploads? int - Total amount of uploads conducted with this share.
- createdAt string - Creation date
- createdBy UserInfo - User information
- dataUrl? string - Upload Share URL
- expireAt? string - Expiration date
- filesExpiryPeriod? int - Number of days after which uploaded files expire
- id int - Share ID
- internalNotes? string - Since v4.11.0 Internal notes
- isEncrypted? boolean - Encryption state
- isProtected boolean - Is share protected by password
- maxSize? int - Maximal total size of uploaded files (in bytes)
- maxSlots? int - Maximal amount of files to upload
- name string - Alias name
- notes? string - User notes
- notifyCreator boolean - Deprecated since v4.20.0 Notify creator on every upload.
- recipients? string - Deprecated since v4.11.0 CSV string of recipient email addresses
- showCreatorName? boolean - Since v4.11.0 Show creator first and last name.
- showCreatorUsername? boolean - Since v4.11.0 Show creator email address.
- showUploadedFiles? boolean - Allow display of already uploaded files
- smsRecipients? string - Deprecated since v4.11.0 CSV string of recipient MSISDNs
- targetId int - Target room or folder ID
- targetPath? string - Path to shared upload node
- targetType? string - Node type
- updatedAt? string - Modification date
- updatedBy? UserInfo - User information
dracoon.public: UploadShareLinkEmail
Request model for sending an email of an Upload Share link
Fields
- body string - Notification email content
- receiverLanguage? string - Language tag for messages to receiver
- recipients string[] - List of recipient email addresses
dracoon.public: UploadShareList
List of Upload Shares
Fields
- items UploadShare[] - List of Upload Shares
- range Range - Range information
dracoon.public: UserAccount
User information
Fields
- authData UserAuthData - User Authentication Data
- authMethods? UserAuthMethod[] - Deprecated since v4.13.0
Authentication methods:
-
sql -
active_directory -
radius -
openid
authDatainstead -
- customer CustomerData - Customer information
- email? string - Email
- expireAt? string - Expiration date
- firstName string - User first name
- gender string(default "n") - Deprecated since v4.12.0 Gender
- hasManageableRooms boolean - User has manageable rooms
- homeRoomId? int - Homeroom ID
- id int - Unique identifier for the user
- isEncryptionEnabled? boolean - User has generated private key. Possible if client-side encryption is active for this customer
- isLocked boolean - User is locked:
-
false- unlocked -
true- locked
-
- language string - Since v4.20.0 IETF language tag
- lastLoginFailAt? string - Last failed logon date
- lastLoginFailIp? string - Deprecated since v4.6.0 Last failed logon IP address
- lastLoginSuccessAt? string - Last successful logon date
- lastLoginSuccessIp? string - Deprecated since v4.6.0 Last successful logon IP address
- lastName string - User last name
- lockStatus int - Deprecated since v4.7.0
User lock status:
-
0- locked -
1- Web access allowed -
2- Web and mobile access allowed
isLockedinstead. -
- login? string - Deprecated since v4.13.0 User login name
- mustSetEmail boolean(default false) - Since v4.13.0
If
true, the user must set theemailat the first login.
- needsToAcceptEULA? boolean - User has accepted EULA.
Present, if EULA is system global active.
cf.
GET system/config/settings/general-eulaEnabled
- needsToChangePassword boolean - Deprecated since v4.13.0 Determines whether user has to change his / her password
- needsToChangeUserName boolean(default false) - Deprecated since v4.13.0
If
true, the user must change theuserNameat the first login.
- phone? string - Phone number
- title? string - Deprecated since v4.18.0 Job title
- userAttributes? UserAttributes - User custom attributes (list of key-value pairs)
- userGroups? UserGroup[] - All groups the user is member of
- userName string - Since v4.13.0 Username
- userRoles RoleList - List of roles
dracoon.public: UserAttributes
Deprecated
User custom attributes (list of key-value pairs)
Fields
- items KeyValueEntry[] - List of key-value pairs
Deprecated
dracoon.public: UserAuthData
User Authentication Data
Fields
- adConfigId? int - ID of the user's Active Directory.
- login? string - User login name
- method string - Authentication method
Authentication methods:
-
basic -
active_directory -
radius -
openid
-
- mustChangePassword? boolean - Determines whether user has to change his / her password
-
default:
trueforbasicauth type -
default:
falseforactive_directory,openidandradiusauth types
-
default:
- oidConfigId? int - ID of the user's OIDC provider.
- password? string - Password (only relevant for
basicauthentication type) NOT your Active Directory, OpenID or RADIUS password!
dracoon.public: UserAuthDataUpdateRequest
User Authentication Data Update Request
Fields
- adConfigId? int - ID of the user's Active Directory.
- login? string - User login name
- method? string - Authentication method
Authentication methods:
-
basic -
active_directory -
radius -
openid
-
- oidConfigId? int - ID of the user's OIDC provider.
dracoon.public: UserAuthMethod
Deprecated
Authentication method
Fields
- authId string - Authentication method
Authentication methods:
-
basic -
active_directory -
radius -
openid
-
- isEnabled boolean - Is enabled
- options? KeyValueEntry[] - Authentication method options
Deprecated
dracoon.public: UserData
User information
Fields
- authData UserAuthData - User Authentication Data
- authMethods? UserAuthMethod[] - Deprecated since v4.13.0
Authentication methods:
-
sql -
active_directory -
radius -
openid
authDatainstead -
- avatarUuid string - Since v4.11.0 Avatar UUID
- email? string - Email
- expireAt? string - Expiration date
- firstName string - User first name
- gender string(default "n") - Deprecated since v4.12.0 Gender
- hasManageableRooms? boolean - User has manageable rooms
- homeRoomId? int - Homeroom ID
- id int - Unique identifier for the user
- isEncryptionEnabled? boolean - User has generated private key. Possible if client-side encryption is active for this customer
- isLocked boolean - User is locked:
-
false- unlocked -
true- locked
-
- lastLoginSuccessAt? string - Last successful logon date
- lastName string - User last name
- lockStatus int - Deprecated since v4.7.0
User lock status:
-
0- locked -
1- Web access allowed -
2- Web and mobile access allowed
isLockedinstead. -
- login? string - Deprecated since v4.13.0 User login name
- phone? string - Phone number
- publicKeyContainer? PublicKeyContainer - Public key container
- title? string - Deprecated since v4.18.0 Job title
- userAttributes? UserAttributes - User custom attributes (list of key-value pairs)
- userName string - Since v4.13.0 Username
- userRoles? RoleList - List of roles
dracoon.public: UserFileKey
User file key
Fields
- fileKey FileKey - File key information
- userId int - Unique identifier for the user
dracoon.public: UserFileKeyList
Deprecated
List of user file keys
Fields
- items? UserFileKey[] - List of user file keys
Deprecated
dracoon.public: UserFileKeySetBatchRequest
List of request models for setting a user file key(s)
Fields
- items UserFileKeySetRequest[] - List of user file keys
dracoon.public: UserFileKeySetRequest
Request model for setting a user file key
Fields
- fileId int - File ID
- fileKey FileKey - File key information
- userId int - Unique identifier for the user
dracoon.public: UserGroup
Group information
Fields
- id int - Unique identifier for the group
- isMember boolean - Determines whether user is a member of the group or not
- name string - Group name
dracoon.public: UserGroupList
List of groups
Fields
- items UserGroup[] - List of user-group mappings
- range Range - Range information
dracoon.public: UserIdFileIdItem
User ID and file ID mapping
Fields
- fileId? int - File ID
- userId? int - Unique identifier for the user
dracoon.public: UserIds
List of user IDs
Fields
- ids int[] - List of user IDs
dracoon.public: UserInfo
User information
Fields
- avatarUuid string - Since v4.11.0 Avatar UUID
- displayName? string - Deprecated since v4.11.0
Display name
use other fields from
UserInfoinstead to combine a display name
- email? string - Since v4.11.0 Email
- firstName string - Since v4.11.0
User first name (mandatory if
userTypeisinternal)
- id int - Unique identifier for the user
- lastName string - Since v4.11.0
User last name (mandatory if
userTypeisinternal)
- title? string - Deprecated since v4.18.0 Job title
- userName string - Since v4.13.0
Username (only returned for
internalusers)
- userType string - Since v4.11.0
User type:
-
internal- ordinary DRACOON user -
external- external user without DRACOON account -
system- system user (non human ) -
deleted- deleted DRACOON user
-
dracoon.public: UserItem
User information
Fields
- avatarUuid string - Since v4.11.0 Avatar UUID
- createdAt? string - Creation date
- email? string - Email
- expireAt? string - Expiration date
- firstName string - User first name
- gender string(default "n") - Deprecated since v4.12.0 Gender
- hasManageableRooms? boolean - Deprecated since v4.27.0 User has manageable rooms
- homeRoomId? int - Homeroom ID
- id int - Unique identifier for the user
- isEncryptionEnabled? boolean - User has generated private key. Possible if client-side encryption is active for this customer
- isLocked boolean - User is locked:
-
false- unlocked -
true- locked
-
- lastLoginSuccessAt? string - Last successful logon date
- lastName string - User last name
- lockStatus int - Deprecated since v4.7.0
User lock status:
-
0- locked -
1- Web access allowed -
2- Web and mobile access allowed
isLockedinstead. -
- login string - Deprecated since v4.13.0 User login name
- phone? string - Phone number
- title? string - Deprecated since v4.18.0 Job title
- userAttributes? UserAttributes - User custom attributes (list of key-value pairs)
- userName string - Since v4.13.0 Username
- userRoles? RoleList - List of roles
dracoon.public: UserKeyPairContainer
Key pair container
Fields
- privateKeyContainer PrivateKeyContainer - Private key container
- publicKeyContainer PublicKeyContainer - Public key container
dracoon.public: UserList
List of users
Fields
- items UserItem[] - List of users
- range Range - Range information
dracoon.public: UserLockout
User lockout information
Fields
- enabled boolean - Determines whether user lockout is enabled
- lockoutPeriod? int - Amount of minutes a user has to wait to make another login attempt after
maxNumberOfLoginFailureshas been exceeded
- maxNumberOfLoginFailures? int - Maximum allowed number of failed login attempts
dracoon.public: UserUserPublicKey
Public key information
Fields
- id? int - Unique identifier for the user
- publicKeyContainer? PublicKeyContainer - Public key container
dracoon.public: UserUserPublicKeyList
List of user public keys
Fields
- items UserUserPublicKey[] - List of user public keys
dracoon.public: ViolatedPasswordPolicy
Violated password policy information
Fields
- message? string - Message from password validator
- name? string - Name of the violated password policy
dracoon.public: Webhook
Webhook information
Fields
- createdAt string - Creation date
- createdBy? UserInfo - User information
- eventTypeNames string[] - List of names of event types
- expireAt string - Expiration date / time
- failStatus? int - Last HTTP status code when a webhook is disabled due to delivery failures
- id int - ID
- isEnabled boolean - Is enabled
- name string - Name
- secret? string - Secret; used for event message signatures
- updatedAt string - Modification date
- updatedBy? UserInfo - User information
- url string - URL
dracoon.public: WebhookList
List of webhooks
Fields
- items Webhook[] - List of webhooks
- range Range - Range information
dracoon.public: ZipDownloadRequest
Request model for ZIP download
Fields
- nodeIds int[] - List of node IDs
Union types
dracoon.public: InlineResponse400
InlineResponse400
Array types
dracoon.public: ThirdPartyDependenciesDataArr
ThirdPartyDependenciesDataArr