dracoon-api — quality + safety report

---
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 | /v4/user/subscriptions/download_shares/{share_id} | Unsubscribe Download Share from notifications |
| GET | /v4/user/account/mfa/totp | Request information to setup TOTP as second authentication factor |
| POST | /v4/user/account/mfa/totp | Confirm second factor TOTP setup with a generated OTP |
| GET | /v4/user/account/keypairs | Request all user key pairs |
| POST | /v4/user/account/keypairs | Create key pair and preserve copy of old private key |
| GET | /v4/user/account/keypair | Request user's key pair |
| POST | /v4/user/account/keypair | Set user's key pair |
| DELETE | /v4/user/account/keypair | Remove user's key pair |
| GET | /v4/user/account/avatar | Request avatar |
| POST | /v4/user/account/avatar | Change avatar |
| DELETE | /v4/user/account/avatar | Reset avatar |
| GET | /v4/user/ping | (authenticated) Ping |
| GET | /v4/user/oauth/authorizations | Request list of OAuth client authorizations |
| GET | /v4/user/oauth/approvals | Request list of OAuth client approvals |
| GET | /v4/user/notifications/config | Request list of notification configurations |
| GET | /v4/user/account/mfa | Request information about the user's mfa status |
| DELETE | /v4/user/account/mfa | Using emergency-code |
| GET | /v4/user/account/customer/keypair | Request customer's key pair |
| DELETE | /v4/user/profileAttributes/{key} | Remove user profile attribute |
| DELETE | /v4/user/oauth/authorizations/{client_id} | Remove all OAuth authorizations of a client |
| DELETE | /v4/user/oauth/authorizations/{client_id}/{authorization_id} | Remove a OAuth authorization |
| DELETE | /v4/user/oauth/approvals/{client_id} | Remove OAuth client approval |
| DELETE | /v4/user/account/mfa/totp/{id} | Disable a MFA TOTP setup with generated OTP |

### 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 | Change guest user policies |
| GET | /v4/system/config/policies/classifications | Request classification policies |
| PUT | /v4/system/config/policies/classifications | Change classification policies |
| GET | /v4/system/config/oauth/clients/{client_id} | Request OAuth client |
| PUT | /v4/system/config/oauth/clients/{client_id} | Update OAuth client |
| DELETE | /v4/system/config/oauth/clients/{client_id} | Remove OAuth client |
| GET | /v4/system/config/auth/openid/idps/{idp_id} | Request OpenID Connect IDP configuration |
| PUT | /v4/system/config/auth/openid/idps/{idp_id} | Update OpenID Connect IDP configuration |
| DELETE | /v4/system/config/auth/openid/idps/{idp_id} | Remove OpenID Connect IDP configuration |
| GET | /v4/system/config/auth/ads/{ad_id} | Request Active Directory configuration |
| PUT | /v4/system/config/auth/ads/{ad_id} | Update Active Directory configuration |
| DELETE | /v4/system/config/auth/ads/{ad_id} | Remove Active Directory configuration |
| GET | /v4/system/config/storage/s3/tags | Request list of configured S3 tags |
| POST | /v4/system/config/storage/s3/tags | Create S3 tag |
| POST | /v4/system/config/policies/passwords/enforce_change | Enforce login password change for all users |
| GET | /v4/system/config/oauth/clients | Request list of OAuth clients |
| POST | /v4/system/config/oauth/clients | Create OAuth client |
| GET | /v4/system/config/auth/openid/idps | Request list of OpenID Connect IDP configurations |
| POST | /v4/system/config/auth/openid/idps | Create OpenID Connect IDP configuration |
| GET | /v4/system/config/auth/ads | Request list of Active Directory configurations |
| POST | /v4/system/config/auth/ads | Create Active Directory configuration |
| POST | /v4/system/config/actions/test/ad | Test Active Directory configuration |
| GET | /v4/system/config/storage/s3/tags/{id} | Request S3 tag |
| DELETE | /v4/system/config/storage/s3/tags/{id} | Remove S3 tag |
| GET | /v4/system/config/settings/infrastructure | Request infrastructure properties |
| GET | /v4/system/config/policies/passwords/{password_type} | Request password policies for a certain password type |

### 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 Sha

… (truncated)