OpenParable
Skip to content
← Back to skills

Bkend Storage

Apps & Automation
bkend-storage

Bkend Storage is an Agent Skill for apps & automation published in the popup-studio-ai/bkit-claude-code repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

bkend.ai file storage — upload (presigned URL), download (CDN), visibility levels, buckets. Triggers: bkend file, upload, download, presigned URL, storage, 파일 업로드, 스토리지.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/popup-studio-ai/bkit-claude-code/blob/HEAD/skills/bkend-storage/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/bkend-storage, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

bkend.ai Storage Guide

Upload Methods

MethodUse CaseProcess
SingleNormal filesPresigned URL -> PUT upload -> Register metadata
MultipleMultiple filesRepeat single upload
MultipartLarge filesInitialize -> Part URLs -> Complete

Presigned URL

  • Validity: 15 minutes
  • PUT method with file binary
  • Content-Type header required

File Visibility (4 levels)

LevelAccessURL Type
publicAnyoneCDN URL (no expiry)
privateOwner onlyPresigned URL (1 hour)
protectedAuthenticated usersPresigned URL (1 hour)
sharedSpecified targetsPresigned URL (1 hour)

Size Limits

CategoryMax Size
Images10 MB
Videos100 MB
Documents20 MB

Storage Categories

images, documents, media, attachments

MCP Storage Workflow

bkend MCP does NOT have dedicated storage tools. Use this workflow:

  1. Search docs: search_docs with query "file upload presigned url"
  2. Get examples: search_docs with query "file upload code examples"
  3. Generate code: AI generates REST API code for file operations

Searchable Storage Docs

Doc IDContent
7_code_examples_dataCRUD + file upload code examples

REST Storage API

MethodEndpointDescription
POST/v1/files/presigned-urlGenerate presigned URL
POST/v1/filesRegister metadata (complete upload)
GET/v1/filesFile list
GET/v1/files/:fileIdFile detail
PATCH/v1/files/:fileIdUpdate metadata
DELETE/v1/files/:fileIdDelete file
POST/v1/files/:fileId/download-urlGenerate download URL

Multipart Upload (Large Files)

MethodEndpointDescription
POST/v1/files/multipart/initInitialize multipart upload
POST/v1/files/multipart/presigned-urlGet part upload URL
POST/v1/files/multipart/completeComplete multipart upload
POST/v1/files/multipart/abortAbort 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: