About bkend-storage
bkend-storage is a file-storage guide for developers using bkend.ai. It describes presigned URLs, visibility levels, REST endpoints, and multipart upload flows for managing files.
Key features
- 01Single and multiple file upload flows
- 02Multipart uploads for large files
- 03Four file visibility levels
- 04File management REST API
- 05Find examples through document search
Use cases
- 01Upload ordinary files
- 02Handle large files in parts
- 03Serve files with access controls
- 04Find code examples for file operations
MCP support
The guide notes that bkend MCP has no dedicated storage tools. MCP clients can search storage documentation and use it to generate REST API code for file operations.
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ ww-w-ai/ bkit-claude-code --skill bkend-storageAfter installing, type/bkend-storagein Claude Code to confirm it loaded.
Details
From the project READMEbkend.ai Storage Guide
Upload Methods
| Method | Use Case | Process |
|---|---|---|
| Single | Normal files | Presigned URL -> PUT upload -> Register metadata |
| Multiple | Multiple files | Repeat single upload |
| Multipart | Large files | Initialize -> Part URLs -> Complete |
Presigned URL
- Validity: 15 minutes
- PUT method with file binary
- Content-Type header required
File Visibility (4 levels)
| Level | Access | URL Type |
|---|---|---|
| public | Anyone | CDN URL (no expiry) |
| private | Owner only | Presigned URL (1 hour) |
| protected | Authenticated users | Presigned URL (1 hour) |
| shared | Specified targets | Presigned URL (1 hour) |
Size Limits
| Category | Max Size |
|---|---|
| Images | 10 MB |
| Videos | 100 MB |
| Documents | 20 MB |
Storage Categories
images, documents, media, attachments
MCP Storage Workflow
bkend MCP does NOT have dedicated storage tools. Use this workflow:
- Search docs:
search_docswith query "file upload presigned url" - Get examples:
search_docswith query "file upload code examples" - Generate code: AI generates REST API code for file operations
Searchable Storage Docs
| Doc ID | Content |
|---|---|
7_code_examples_data | CRUD + file upload code examples |
REST Storage API
| Method | Endpoint | Description |
|---|---|---|
| POST | /v1/files/presigned-url | Generate presigned URL |
| POST | /v1/files | Register metadata (complete upload) |
| GET | /v1/files | File list |
| GET | /v1/files/:fileId | File detail |
| PATCH | /v1/files/:fileId | Update metadata |
| DELETE | /v1/files/:fileId | Delete file |
| POST | /v1/files/:fileId/download-url | Generate download URL |
Multipart Upload (Large Files)
| Method | Endpoint | Description |
|---|---|---|
| POST | /v1/files/multipart/init | Initialize multipart upload |
| POST | /v1/files/multipart/presigned-url | Get part upload URL |
| POST | /v1/files/multipart/complete | Complete multipart upload |
| POST | /v1/files/multipart/abort | Abort multipart upload |
Upload Flow (Single File)
1. POST /v1/files/presigned-url -> { url, fileId }
2. PUT {url} with file binary + Content-Type header
3. POST /v1/files with { fileId, filename, contentType, size, visibility }
Multipart Upload Flow (Large File)
1. POST /v1/files/multipart/init -> { uploadId }
2. POST /v1/files/multipart/presigned-url -> [{ partNumber, url }]
3. PUT each part URL with file chunk
4. POST /v1/files/multipart/complete -> { file }
Official Documentation (Live Reference)
For the latest storage documentation, use WebFetch:
- Storage Overview: https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/storage/01-overview.md
- MCP Storage Guide: https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/mcp/07-storage-tools.md
- Full TOC: https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/SUMMARY.md
Comments
Markdown supported