Documentation
Quick Start
Get up and running with the ZeroDesk API in minutes.
Prerequisites
- A ZeroDesk account (sign up here)
- An API key (generated from Developer Settings)
Step 1: Get Your API Key
- Log into your ZeroDesk account
- Navigate to Settings > Developer > API Keys
- Click Create New API Key
- Give it a name and select the permissions you need
- Copy the generated key (starts with
zd_live_)
Important: Store your API key securely. It won't be shown again.
Step 2: Make Your First Request
Let's verify your API key works by fetching your storage quota:
Using cURL
Using JavaScript
Using Python
Expected Response
Step 3: Upload Your First File
Using cURL
Using JavaScript
Expected Response
Step 4: List Your Files
Response
Step 5: Download a File
This returns a signed URL that you can use to download the file:
Common Operations Quick Reference
| Operation | Method | Endpoint |
|---|---|---|
| List files | GET | /api/v1/files |
| Upload file | POST | /api/v1/files/upload |
| Get file info | GET | /api/v1/files/{fileId} |
| Download file | GET | /api/v1/files/{fileId}/download |
| Delete file | DELETE | /api/v1/files/{fileId} |
| Create folder | POST | /api/v1/folders/create |
| Share file | POST | /api/v1/files/{fileId}/share |
| List workspaces | GET | /api/v1/workspaces |
Error Handling
Always check the success field in responses:
Next Steps
- File Upload Guide - Learn advanced upload techniques
- Sharing Files Guide - Share content with others
- Workspaces Guide - Collaborate with teams
- Authentication Reference - Deep dive into auth options