ZDrive

ZDrive API

Public API reference for ZDrive - secure cloud storage. Authenticate by logging in via POST /auth/login, which sets an httpOnly session cookie sent automatically on subsequent requests.

Version 1.4.1 · 62 endpoints · base URL https://zhdrive.in/api

Open interactive Swagger UI

Authentication

Most endpoints require an active session. Call POST /auth/login with an email and password - on success the response sets an httpOnly session cookie that your browser or HTTP client sends automatically on every subsequent request to this API. There is no separate API key or bearer token to manage. Endpoints marked Public work without a session; everything else needs one.

Auth

post/api/auth/register Requires session

Request body

Field	Type	Required
email	string (email)	yes
password	string	yes
name	string	no

post/api/auth/login Requires session

Parameters

Name	In	Type	Required
user-agent	header	string	yes

Request body

Field	Type	Required
email	string (email)	yes
password	string	yes

post/api/auth/login/2fa Requires session

Parameters

Name	In	Type	Required
user-agent	header	string	yes

Request body

Field	Type	Required
challengeToken	string	yes
code	string	yes

post/api/auth/google/token Requires session

Parameters

Name	In	Type	Required
user-agent	header	string	yes

Request body

Field	Type	Required
idToken	string	yes

get/api/auth/me Requires session

post/api/auth/logout Requires session

post/api/auth/change-password Requires session

Parameters

Name	In	Type	Required
user-agent	header	string	yes

Request body

Field	Type	Required
currentPassword	string	yes
newPassword	string	yes

get/api/auth/sessions Requires session

delete/api/auth/sessions/{id} Requires session

Parameters

Name	In	Type	Required
id	path	string	yes

post/api/auth/2fa/setup Requires session

post/api/auth/2fa/verify Requires session

Request body

Field	Type	Required
code	string	yes

post/api/auth/2fa/disable Requires session

Request body

Field	Type	Required
password	string	yes

post/api/auth/forgot-password Requires session

Request body

Field	Type	Required
email	string (email)	yes

post/api/auth/reset-password Requires session

Request body

Field	Type	Required
token	string	yes
password	string	yes

post/api/auth/verify-email Requires session

Request body

Field	Type	Required
token	string	yes

post/api/auth/resend-verification Requires session

Request body

Field	Type	Required
email	string (email)	yes

Users

get/api/users/me Requires session

get/api/users/profile Requires session

patch/api/users/profile Requires session

Request body

Field	Type	Required
name	string	no

post/api/users/avatar Requires session

get/api/users/storage Requires session

get/api/users/activity Requires session

delete/api/users/account Requires session

Folders

post/api/folders Requires session

Request body

Field	Type	Required
name	string	yes
parentId	string	no

get/api/folders Requires session

get/api/folders/all Requires session

get/api/folders/search/{query} Requires session

Parameters

Name	In	Type	Required
query	path	string	yes

get/api/folders/{id}/children Requires session

Parameters

Name	In	Type	Required
id	path	string	yes

get/api/folders/{id}/explorer Requires session

Parameters

Name	In	Type	Required
id	path	string	yes

get/api/folders/{id} Requires session

Parameters

Name	In	Type	Required
id	path	string	yes

patch/api/folders/{id} Requires session

Parameters

Name	In	Type	Required
id	path	string	yes

Request body

Field	Type	Required
name	string	yes

delete/api/folders/{id} Requires session

Parameters

Name	In	Type	Required
id	path	string	yes

Files

get/api/files/share/{token} Requires session

Parameters

Name	In	Type	Required
token	path	string	yes

get/api/files/share/{token}/content Requires session

Parameters

Name	In	Type	Required
token	path	string	yes

get/api/files/bulk-download/content Requires session

Parameters

Name	In	Type	Required
ticket	query	string	yes

get/api/files/{id}/content Requires session

Parameters

Name	In	Type	Required
id	path	string	yes
ticket	query	string	yes
disposition	query	string	yes

get/api/files Requires session

get/api/files/search/{query} Requires session

Parameters

Name	In	Type	Required
query	path	string	yes
user-agent	header	string	yes

get/api/files/search-semantic/{query} Requires session

Parameters

Name	In	Type	Required
query	path	string	yes
user-agent	header	string	yes

get/api/files/search-semantic-documents/{query} Requires session

Parameters

Name	In	Type	Required
query	path	string	yes
user-agent	header	string	yes

get/api/files/trash Requires session

get/api/files/folder/{folderId} Requires session

Parameters

Name	In	Type	Required
folderId	path	string	yes

get/api/files/shared Requires session

delete/api/files/share/{shareId} Requires session

Parameters

Name	In	Type	Required
shareId	path	string	yes
user-agent	header	string	yes

get/api/files/{id}/versions Requires session

Parameters

Name	In	Type	Required
id	path	string	yes

post/api/files/{id}/version Requires session

Parameters

Name	In	Type	Required
id	path	string	yes
user-agent	header	string	yes

get/api/files/{id} Requires session

Parameters

Name	In	Type	Required
id	path	string	yes

patch/api/files/{id} Requires session

Parameters

Name	In	Type	Required
id	path	string	yes
user-agent	header	string	yes

Request body

Field	Type	Required
name	string	yes

delete/api/files/{id} Requires session

Parameters

Name	In	Type	Required
id	path	string	yes
user-agent	header	string	yes

get/api/files/{id}/download Requires session

Parameters

Name	In	Type	Required
id	path	string	yes
user-agent	header	string	yes

post/api/files/bulk-download-ticket Requires session

Request body

Field	Type	Required
fileIds	string[]	no
folderIds	string[]	no

patch/api/files/{id}/move Requires session

Parameters

Name	In	Type	Required
id	path	string	yes
user-agent	header	string	yes

Request body

Field	Type	Required
folderId	string	no

post/api/files/{id}/share Requires session

Parameters

Name	In	Type	Required
id	path	string	yes
user-agent	header	string	yes

patch/api/files/{id}/restore Requires session

Parameters

Name	In	Type	Required
id	path	string	yes
user-agent	header	string	yes

delete/api/files/{id}/permanent Requires session

Parameters

Name	In	Type	Required
id	path	string	yes
user-agent	header	string	yes

Storage

post/api/storage/upload Requires session

Parameters

Name	In	Type	Required
user-agent	header	string	yes

post/api/storage/upload/bulk Requires session

Parameters

Name	In	Type	Required
user-agent	header	string	yes

Dashboard

get/api/dashboard/stats Requires session

Billing

get/api/billing/plans Requires session

Parameters

Name	In	Type	Required
audience	query	string	no

get/api/billing/subscription Requires session

post/api/billing/razorpay/create-order Requires session

Request body

Field	Type	Required
planCode	string	yes

post/api/billing/razorpay/verify Requires session

Request body

Field	Type	Required
razorpayOrderId	string	yes
razorpayPaymentId	string	yes
razorpaySignature	string	yes