Cloudreve API Docs
Setting
Copy Page
Cloudreve API Docs
Site
Ping
GET
Get CAPTCHA
GET
Get site settings
GET
Session
Token
Password sign-in
Finish sign-in with 2FA
Refresh Token
Sign out
OpenID
Prepare OpenID sign-in
Finish OpenID sign-in
Unlink OpenID
Passkey
Prepare Passkey sign-in
Finish Passkey sign-in
Prepare login
GET
User
Passkey
Prepare passkey registration
Finish passkey registration
Delete passkey
Setting
List available storage policies
GET
List available nodes
GET
Get preferences
GET
Prepare enabling 2FA
GET
Update preference setting
PATCH
Update profile pricture
PUT
Sign up
POST
Send reset password email
POST
Reset password via temp link
PATCH
Get profile picture
GET
Get user
GET
List user's share links
GET
Get storage capacity
GET
Search user
GET
List credit changes
GET
List payments
GET
Callback
Complete OneDrive upload
GET
Complete COS upload
GET
Complete S3 upload
GET
Complete OBS upload
GET
Workflow
Remote Download
Create remote download
Select files to download
Cancel task
List tasks
Get task progress
Create archive
Extract archive
Relocate storage policy
Import external files
File
Permission
Set permission
Delete permission setting
Upload
Create upload session
Upload file chunk
Delete upload session
Pin
Pin to sidebar
Delete a pin
Version
Set file version
Delete file version
Direct Link
Create direct links
Delete direct link
List files
List file activities
Get file info
Get thumbnail URL
Update file content
Create viewer session
Create file
Rename file
Move or copy files
Create download URL
Restore from trash bin
Delete file
Force unlock
Patch metadata
Mount storage policy
Update view setting
Share
Create share link
Edit share link
Get share link info
List my share links
Delete share link
VAS
Payment
Create a payment
Get payment status
GiftCode
Check gift code
Redeem gift code
Group
List groups
WebDAV
List accounts
Create account
Update account
Delete account
Setting
Copy Page
Update profile pricture
PUT
/user/setting/avatar
Try it
Run in Apifox
Run in Apifox
Behaviour of this method depends on the request body:
If requerst body is empty, the user profile pciture will set to using Gravatar.
If request body is not empty, and
Content-Length
>
0
, the body will be parsed as image file, and used as the new profile picture.
Request
Authorization
Add the parameter
Authorization
to Headers
,whose value is to concatenate the Token after the Bearer.
Example:
Authorization: Bearer ********************
Body Params
application/octet-stream
Not configured
Request samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request
Request Example
Shell
JavaScript
Java
Swift
cURL
cURL-Windows
Httpie
wget
PowerShell
Responses
🟢
200
Success
application/json
Generate Code
Body
Generate Code
code
integer
Â
required
Response code.
0
- Success.
Default:
0
Example:
0
msg
string
Â
optional
Human readable error message (if any).
error
string
Â
Â
|
Â
null
Â
optional
Internal error message, only visable in debug mode.
correlation_id
string
Â
<uuid>
Â
|
Â
null
Â
optional
Correlation ID of the request. Only presented on failed reqeust.
Example:
b4351ecc-ee1a-4455-bc94-2c3dbcc58538
Example
{
"code"
:
0
,
"msg"
:
""
}
Modified atÂ
2025-06-13 04:01:41
Previous
Update preference setting
Next
Sign up