Nyota Drive
REST API Reference
Raw HTTP endpoints for Nyota Drive.
If you prefer not to use the @nyota/drive-sdk, you can interact with the Drive API directly using standard HTTP requests.
All requests require the x-nyota-api-key header.
Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /v1/drive/workspaces/:id/summary | Fetch storage quota and consumption metrics. |
| POST | /v1/drive/files/upload/request | Negotiate an upload reservation and fetch a presigned URL. |
| POST | /v1/drive/files/upload/commit | Finalize an upload after successful S3 PutObject. |
| GET | /v1/drive/files | List active or deleted files. |
| DELETE | /v1/drive/files/:id | Move a file to the trash. |
| POST | /v1/drive/files/:id/restore | Restore a file from the trash. |
| DELETE | /v1/drive/files/:id/force | Permanently purge a file from Cloudflare R2. |
| PATCH | /v1/drive/files/:id/visibility | Transition between public CDN and private buckets. |
| PATCH | /v1/drive/files/:id/move | Move a file to a new folder. |
| PATCH | /v1/drive/files/:id/rename | Rename a file. |
| GET | /v1/drive/folders | List folders. |
| POST | /v1/drive/folders | Create a new folder. |
| DELETE | /v1/drive/folders/:id | Move a folder and all contents to the trash. |
| POST | /v1/drive/shares | Create a secure share link. |
| DELETE | /v1/drive/shares/:id/revoke | Revoke a share token. |
| POST | /v1/drive/shares/public/:token | (Unauthenticated) Resolve a share token to an S3 URL. |