dracoon-api

name	dracoon-api
description	DRACOON API skill. Use when working with DRACOON for public, downloads, users. Covers 314 endpoints.
version	1.0.0
generator	lapsh

DRACOON API

API version: 5.47.0

Auth

OAuth2

Base URL

/api

Setup

1. Configure auth: OAuth2
2. GET /v4/user/subscriptions/upload_shares -- verify access
3. POST /v4/users/{user_id}/userAttributes -- create first userAttributes

Endpoints

314 endpoints across 17 groups. See references/api-spec.lap for full details.

public

Method	Path	Description
GET	/v4/public/shares/downloads/{access_key}/{token}	Download file with token
HEAD	/v4/public/shares/downloads/{access_key}/{token}	Download file with token
GET	/v4/public/shares/uploads/{access_key}/{upload_id}	Request status of S3 file upload
PUT	/v4/public/shares/uploads/{access_key}/{upload_id}	Complete file upload
POST	/v4/public/shares/uploads/{access_key}/{upload_id}	Upload file
DELETE	/v4/public/shares/uploads/{access_key}/{upload_id}	Cancel file upload
PUT	/v4/public/shares/uploads/{access_key}/{upload_id}/s3	Complete S3 file upload
GET	/v4/public/shares/uploads/{access_key}	Request public Upload Share information
POST	/v4/public/shares/uploads/{access_key}	Create new file upload channel
POST	/v4/public/shares/uploads/{access_key}/{upload_id}/s3_urls	Generate presigned URLs for S3 file upload
GET	/v4/public/shares/downloads/{access_key}	Request public Download Share information
POST	/v4/public/shares/downloads/{access_key}	Generate download URL
HEAD	/v4/public/shares/downloads/{access_key}	Check public Download Share password
GET	/v4/public/time	Request system time
GET	/v4/public/system/info	Request system information
GET	/v4/public/system/info/auth/openid	Request OpenID Connect provider authentication information
GET	/v4/public/system/info/auth/ad	Request Active Directory authentication information
GET	/v4/public/software/version	Request software version information
GET	/v4/public/software/third_party_dependencies	Request third-party software dependencies

downloads

Method	Path	Description
GET	/v4/downloads/{token}	Download file
HEAD	/v4/downloads/{token}	Download file
GET	/v4/downloads/zip/{token}	Download ZIP archive
GET	/v4/downloads/avatar/{user_id}/{uuid}	Download avatar

users

Method	Path	Description
GET	/v4/users/{user_id}	Request user
PUT	/v4/users/{user_id}	Update user's metadata
DELETE	/v4/users/{user_id}	Remove user
GET	/v4/users/{user_id}/userAttributes	Request custom user attributes
PUT	/v4/users/{user_id}/userAttributes	Add or edit custom user attributes
POST	/v4/users/{user_id}/userAttributes	Set custom user attributes
GET	/v4/users	Request users
POST	/v4/users	Create new user
POST	/v4/users/{user_id}/mfa/emergency_code	Request emergency MFA code
GET	/v4/users/{user_id}/rooms	Request rooms granted to the user or / and rooms that can be granted
GET	/v4/users/{user_id}/roles	Request user's granted roles
GET	/v4/users/{user_id}/last_admin_rooms	Request rooms where the user is last admin
GET	/v4/users/{user_id}/groups	Request groups that user is a member of or / and can become a member
DELETE	/v4/users/{user_id}/userAttributes/{key}	Remove custom user attribute
DELETE	/v4/users/{user_id}/mfa	Reset MFA for user

user

Method	Path	Description
GET	/v4/user/subscriptions/upload_shares	List Upload Share subscriptions
PUT	/v4/user/subscriptions/upload_shares	Subscribe or Unsubscribe a List of Upload Shares for notifications
GET	/v4/user/subscriptions/nodes	List node subscriptions
PUT	/v4/user/subscriptions/nodes	Subscribe or Unsubscribe a List of nodes for notifications
GET	/v4/user/subscriptions/download_shares	List Download Share subscriptions
PUT	/v4/user/subscriptions/download_shares	Subscribe or Unsubscribe a List of Download Shares for notifications
GET	/v4/user/profileAttributes	Request user profile attributes
PUT	/v4/user/profileAttributes	Add or edit user profile attributes
POST	/v4/user/profileAttributes	Set user profile attributes
PUT	/v4/user/notifications/config/{id}	Update notification configuration
GET	/v4/user/account	Request user account information
PUT	/v4/user/account	Update user account
PUT	/v4/user/account/password	Change user's password
GET	/v4/user/account/customer	Request customer information for user
PUT	/v4/user/account/customer	Activate client-side encryption for customer
POST	/v4/user/subscriptions/upload_shares/{share_id}	Subscribe Upload Share for notifications
DELETE	/v4/user/subscriptions/upload_shares/{share_id}	Unsubscribe Upload Share from notifications
POST	/v4/user/subscriptions/nodes/{node_id}	Subscribe node for notifications
DELETE	/v4/user/subscriptions/nodes/{node_id}	Unsubscribe node from notifications
POST	/v4/user/subscriptions/download_shares/{share_id}	Subscribe Download Share for notifications
DELETE

uploads

Method	Path	Description
PUT	/v4/uploads/{token}	Complete file upload
POST	/v4/uploads/{token}	Upload file
DELETE	/v4/uploads/{token}	Cancel file upload

system

Method	Path	Description
GET	/v4/system/config/storage/s3	Request S3 storage configuration
PUT	/v4/system/config/storage/s3	Update S3 storage configuration
POST	/v4/system/config/storage/s3	Create S3 storage configuration
GET	/v4/system/config/settings/syslog	Request syslog settings
PUT	/v4/system/config/settings/syslog	Update syslog settings
GET	/v4/system/config/settings/general	Request general settings
PUT	/v4/system/config/settings/general	Update general settings
GET	/v4/system/config/settings/eventlog	Request eventlog settings
PUT	/v4/system/config/settings/eventlog	Update eventlog settings
GET	/v4/system/config/settings/defaults	Request system defaults
PUT	/v4/system/config/settings/defaults	Update system defaults
GET	/v4/system/config/settings/auth	Request authentication settings
PUT	/v4/system/config/settings/auth	Update authentication settings
GET	/v4/system/config/policies/virus_protection	Request virus protection policies
PUT	/v4/system/config/policies/virus_protection	Change virus protection policies
GET	/v4/system/config/policies/passwords	Request password policies
PUT	/v4/system/config/policies/passwords	Change password policies
GET	/v4/system/config/policies/mfa	Request MFA policies
PUT	/v4/system/config/policies/mfa	Change MFA policies
PUT	/v4/system/config/policies/mfa/{user_type}	Change MFA policies for internal/external users
GET	/v4/system/config/policies/guest_users	Request guest user policies
PUT	/v4/system/config/policies/guest_users

shares

Method	Path	Description
GET	/v4/shares/uploads	Request list of Upload Shares
PUT	/v4/shares/uploads	Update List of Upload Shares
POST	/v4/shares/uploads	Create new Upload Share
DELETE	/v4/shares/uploads	Remove Upload Shares
GET	/v4/shares/uploads/{share_id}	Request Upload Share
PUT	/v4/shares/uploads/{share_id}	Update Upload Share
DELETE	/v4/shares/uploads/{share_id}	Remove Upload Share
GET	/v4/shares/downloads	Request list of Download Shares
PUT	/v4/shares/downloads	Update a list of Download Shares
POST	/v4/shares/downloads	Create new Download Share
DELETE	/v4/shares/downloads	Remove Download Shares
GET	/v4/shares/downloads/{share_id}	Request Download Share
PUT	/v4/shares/downloads/{share_id}	Update Download Share
DELETE	/v4/shares/downloads/{share_id}	Remove Download Share
POST	/v4/shares/uploads/{share_id}/email	Send an existing Upload Share link via email
POST	/v4/shares/downloads/{share_id}/email	Send an existing Download Share link via email
GET	/v4/shares/uploads/{share_id}/qr	Request Upload Share via QR Code
GET	/v4/shares/downloads/{share_id}/qr	Request Download Share via QR Code

settings

Method	Path	Description
GET	/v4/settings	Request customer settings
PUT	/v4/settings	Set customer settings
GET	/v4/settings/webhooks/{webhook_id}	Request webhook
PUT	/v4/settings/webhooks/{webhook_id}	Update webhook
DELETE	/v4/settings/webhooks/{webhook_id}	Remove webhook
GET	/v4/settings/notifications/channels	Request list of notification channels
PUT	/v4/settings/notifications/channels	Toggle notification channels
GET	/v4/settings/webhooks	Request list of webhooks
POST	/v4/settings/webhooks	Create webhook
POST	/v4/settings/webhooks/{webhook_id}/reset_lifetime	Reset webhook lifetime
GET	/v4/settings/keypairs	Request all system rescue key pairs
POST	/v4/settings/keypairs	Create system rescue key pair and preserve copy of old private key
GET	/v4/settings/keypair	Request system rescue key pair
POST	/v4/settings/keypair	Activate client-side encryption for customer
DELETE	/v4/settings/keypair	Remove system rescue key pair
GET	/v4/settings/webhooks/event_types	Request list of event types

provisioning

Method	Path	Description
GET	/v4/provisioning/webhooks/{webhook_id}	Request tenant webhook
PUT	/v4/provisioning/webhooks/{webhook_id}	Update tenant webhook
DELETE	/v4/provisioning/webhooks/{webhook_id}	Remove tenant webhook
GET	/v4/provisioning/customers/{customer_id}	Get customer
PUT	/v4/provisioning/customers/{customer_id}	Update customer
DELETE	/v4/provisioning/customers/{customer_id}	Remove customer
GET	/v4/provisioning/customers/{customer_id}/customerAttributes	Request customer attributes
PUT	/v4/provisioning/customers/{customer_id}/customerAttributes	Add or edit customer attributes
POST	/v4/provisioning/customers/{customer_id}/customerAttributes	Set customer attributes
GET	/v4/provisioning/webhooks	Request list of tenant webhooks
POST	/v4/provisioning/webhooks	Create tenant webhook
POST	/v4/provisioning/webhooks/{webhook_id}/reset_lifetime	Reset tenant webhook lifetime
GET	/v4/provisioning/customers	Request list of customers
POST	/v4/provisioning/customers	Create customer
GET	/v4/provisioning/webhooks/event_types	Request list of event types
GET	/v4/provisioning/customers/{customer_id}/users	Request list of customer users
DELETE	/v4/provisioning/customers/{customer_id}/customerAttributes/{key}	Remove customer attribute

nodes

Method	Path	Description
GET	/v4/nodes/{node_id}/node_attributes	Request custom node attributes
PUT	/v4/nodes/{node_id}/node_attributes	Add or edit custom node attributes
PUT	/v4/nodes/rooms/{room_id}	Updates room’s metadata
GET	/v4/nodes/rooms/{room_id}/webhooks	Request list of webhooks that are assigned or can be assigned to this room
PUT	/v4/nodes/rooms/{room_id}/webhooks	Assign or unassign webhooks to room
GET	/v4/nodes/rooms/{room_id}/users	Request room granted user(s) or / and user(s) that can be granted
PUT	/v4/nodes/rooms/{room_id}/users	Add or change room granted user(s)
DELETE	/v4/nodes/rooms/{room_id}/users	Revoke granted user(s) from room
GET	/v4/nodes/rooms/{room_id}/policies	Request Room Policies
PUT	/v4/nodes/rooms/{room_id}/policies	Set room policies
PUT	/v4/nodes/rooms/{room_id}/guest_users	Add guest users to a room
GET	/v4/nodes/rooms/{room_id}/groups	Request room granted group(s) or / and group(s) that can be granted
PUT	/v4/nodes/rooms/{room_id}/groups	Add or change room granted group(s)
DELETE	/v4/nodes/rooms/{room_id}/groups	Revoke granted group(s) from room
PUT	/v4/nodes/rooms/{room_id}/encrypt	Encrypt room
PUT	/v4/nodes/rooms/{room_id}/config	Configure room
GET	/v4/nodes/rooms/pending	Request user-room assignments per group
PUT	/v4/nodes/rooms/pending	Handle user-room assignments per group
PUT	/v4/nodes/folders/{folder_id}	Updates folder’s metadata
PUT	/v4/nodes/files	Updates a list of file’s metadata
PUT	/v4/nodes/files/{file_id}	Updates a file’s metadata

groups

Method	Path	Description
GET	/v4/groups/{group_id}	Request user group
PUT	/v4/groups/{group_id}	Update user group's metadata
DELETE	/v4/groups/{group_id}	Remove user group
GET	/v4/groups	Request list of user groups
POST	/v4/groups	Create new user group
GET	/v4/groups/{group_id}/users	Request group member users or / and users who can become a member
POST	/v4/groups/{group_id}/users	Add group members
DELETE	/v4/groups/{group_id}/users	Remove group members
GET	/v4/groups/{group_id}/rooms	Request rooms granted to the group or / and rooms that can be granted
GET	/v4/groups/{group_id}/roles	Request list of roles assigned to the group
GET	/v4/groups/{group_id}/last_admin_rooms	Request rooms where the group is defined as last admin group

config

Method	Path	Description
GET	/v4/config/settings	Request system settings
PUT	/v4/config/settings	Update system settings
GET	/v4/config/info/s3_tags	Request list of configured S3 tags
GET	/v4/config/info/product_packages	Request list of product packages
GET	/v4/config/info/product_packages/current	Request list of currently enabled product packages
GET	/v4/config/info/policies/virus_protection	Request virus protection
GET	/v4/config/info/policies/passwords	Request password policies
GET	/v4/config/info/policies/guest_users	Request guest users policies
GET	/v4/config/info/policies/classifications	Request classification policies
GET	/v4/config/info/policies/algorithms	Request algorithms
GET	/v4/config/info/notifications/channels	Request list of notification channels
GET	/v4/config/info/infrastructure	Request infrastructure properties
GET	/v4/config/info/general	Request general settings
GET	/v4/config/info/defaults	Request default values

auth

Method	Path	Description
GET	/v4/auth/reset_password/{token}	Validate information for password reset
PUT	/v4/auth/reset_password/{token}	Reset password
POST	/v4/auth/reset_password	Request password reset
POST	/v4/auth/recover_username	Recover username

roles

Method	Path	Description
GET	/v4/roles/{role_id}/users	Request users with specific role
POST	/v4/roles/{role_id}/users	Assign user(s) to the role
DELETE	/v4/roles/{role_id}/users	Revoke granted role from user(s)
GET	/v4/roles/{role_id}/groups	Request groups with specific role
POST	/v4/roles/{role_id}/groups	Assign group(s) to the role
DELETE	/v4/roles/{role_id}/groups	Revoke granted role from group(s)
GET	/v4/roles	Request all roles with assigned rights

datev

Method	Path	Description
GET	/v4/datev/mst/{config_id}/taxyears	Request all addable Datev MST tax years
POST	/v4/datev/mst/{config_id}/taxyears	Create new Datev MST tax year
POST	/v4/datev/mst/{config_id}/sync	Execute Datev MST sync
POST	/v4/datev/mst/authorization/start	Start Datev MST authorization
POST	/v4/datev/mst/authorization/complete	Complete Datev MST authorization
POST	/v4/datev/duo/{config_id}/sync	Execute Datev DUO sync
POST	/v4/datev/duo/authorization/start	Start Datev DUO authorization
POST	/v4/datev/duo/authorization/complete	Complete Datev DUO authorization
GET	/v4/datev	Request Datev sync configuration for room
GET	/v4/datev/mst	Request list of Datev MST sync configurations
GET	/v4/datev/mst/{config_id}	Request Datev MST sync configuration
DELETE	/v4/datev/mst/{config_id}	Remove Datev MST sync configuration
GET	/v4/datev/mst/{config_id}/files	Request information about Datev MST sync files
GET	/v4/datev/mst/{config_id}/files/{file_id}	Request information about a Datev MST sync file
GET	/v4/datev/duo	Request list of Datev DUO sync configurations
GET	/v4/datev/duo/{config_id}	Request Datev DUO sync configuration
DELETE	/v4/datev/duo/{config_id}	Remove Datev DUO sync configuration
GET	/v4/datev/duo/{config_id}/files	Request information about Datev DUO sync files
GET	/v4/datev/duo/{config_id}/files/{file_id}	Request information about a Datev DUO sync file

resources

Method	Path	Description
GET	/v4/resources/users/{user_id}/avatar/{uuid}	Request user avatar
GET	/v4/resources/user/notifications/scopes	Request list of subscription scopes

eventlog

Method	Path	Description
GET	/v4/eventlog/operations	Request allowed Log Operations
GET	/v4/eventlog/events	Request system events
GET	/v4/eventlog/audits/nodes	Request node assigned users with permissions
GET	/v4/eventlog/audits/node_info	Request nodes

Common Questions

Match user requests to endpoints in references/api-spec.lap. Key patterns:

• "Get download details?" -> GET /v4/public/shares/downloads/{access_key}/{token}
• "Get download details?" -> GET /v4/downloads/{token}
• "Get user details?" -> GET /v4/users/{user_id}
• "Update a user?" -> PUT /v4/users/{user_id}
• "Delete a user?" -> DELETE /v4/users/{user_id}
• "List all userAttributes?" -> GET /v4/users/{user_id}/userAttributes
• "Create a userAttribute?" -> POST /v4/users/{user_id}/userAttributes
• "List all upload_shares?" -> GET /v4/user/subscriptions/upload_shares
• "List all nodes?" -> GET /v4/user/subscriptions/nodes
• "List all download_shares?" -> GET /v4/user/subscriptions/download_shares
• "List all profileAttributes?" -> GET /v4/user/profileAttributes
• "Create a profileAttribute?" -> POST /v4/user/profileAttributes
• "Update a config?" -> PUT /v4/user/notifications/config/{id}
• "List all account?" -> GET /v4/user/account
• "List all customer?" -> GET /v4/user/account/customer
• "Update a upload?" -> PUT /v4/uploads/{token}
• "Delete a upload?" -> DELETE /v4/uploads/{token}
• "List all s3?" -> GET /v4/system/config/storage/s3
• "Create a s3?" -> POST /v4/system/config/storage/s3
• "List all syslog?" -> GET /v4/system/config/settings/syslog
• "List all general?" -> GET /v4/system/config/settings/general
• "List all eventlog?" -> GET /v4/system/config/settings/eventlog
• "List all defaults?" -> GET /v4/system/config/settings/defaults
• "List all auth?" -> GET /v4/system/config/settings/auth
• "List all virus_protection?" -> GET /v4/system/config/policies/virus_protection
• "List all passwords?" -> GET /v4/system/config/policies/passwords
• "List all mfa?" -> GET /v4/system/config/policies/mfa
• "Update a mfa?" -> PUT /v4/system/config/policies/mfa/{user_type}
• "List all guest_users?" -> GET /v4/system/config/policies/guest_users
• "List all classifications?" -> GET /v4/system/config/policies/classifications
• "Get client details?" -> GET /v4/system/config/oauth/clients/{client_id}
• "Update a client?" -> PUT /v4/system/config/oauth/clients/{client_id}
• "Delete a client?" -> DELETE /v4/system/config/oauth/clients/{client_id}
• "Get idp details?" -> GET /v4/system/config/auth/openid/idps/{idp_id}
• "Update a idp?" -> PUT /v4/system/config/auth/openid/idps/{idp_id}
• "Delete a idp?" -> DELETE /v4/system/config/auth/openid/idps/{idp_id}
• "Get ad details?" -> GET /v4/system/config/auth/ads/{ad_id}
• "Update a ad?" -> PUT /v4/system/config/auth/ads/{ad_id}

Response Tips

• Check response schemas in references/api-spec.lap for field details
• List endpoints may support pagination; check for limit, offset, or cursor params
• Create/update endpoints typically return the created/updated object

References

• Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas

Generated from the official API spec by LAP