KVSEC Public API — simple key-value storage with public read access and authenticated write/delete operations.
Generates a pair of access keys linked to a new bucket:
No authentication required.
| bucket_id required | string |
| write_key required | string |
| read_key required | string |
curl -s -X POST https://api.kvsec.io/auth/keygen
{- "bucket_id": "bkt_3w5k5m0q",
- "write_key": "kvw_6Qy...x2A",
- "read_key": "kvr_Mc9...r4K"
}Returns the stored data for the given {bucketId} and {key}.
Dynamic content type: the response Content-Type matches the media type
that was originally uploaded with the object.
Below are representative content-types; the actual response will use the exact media type saved during upload.
| bucketId required | string Example: bkt_3w5k5m0q Unique bucket ID from |
| key required | string Example: hello.txt Object key (filename) within the bucket |
curl -s https://api.kvsec.io/pub/bkt_3w5k5m0q/hello.txt
hello world
Creates or replaces an object under {bucketId} and {key}.
Requires a valid write key in header X-Kvsec-Key.
The request body may use any Content-Type (*/*), such as text/plain,
application/json, image/png, etc. The server stores the original
Content-Type and returns it during reads.
| bucketId required | string Example: bkt_3w5k5m0q Unique bucket ID from |
| key required | string Example: hello.txt Object key (filename) within the bucket |
Object payload to store. Content-Type is recommended.
| status required | string |
| bucket_id required | string |
| key required | string |
| url required | string <uri> |
| content_type required | string |
hello world
{- "status": "ok",
- "bucket_id": "bkt_3w5k5m0q",
- "key": "hello.txt",
- "content_type": "text/plain"
}Deletes an object by {bucketId} and {key}.
Requires a write key in header X-Kvsec-Key.
| bucketId required | string Example: bkt_3w5k5m0q Unique bucket ID from |
| key required | string Example: hello.txt Object key (filename) within the bucket |
| status required | string |
| bucket_id required | string |
| key required | string |
curl -s -X DELETE \ -H "X-Kvsec-Key: kvw_6Qy...x2A" \ https://api.kvsec.io/pub/bkt_3w5k5m0q/hello.txt
{- "status": "ok",
- "bucket_id": "bkt_3w5k5m0q",
- "key": "hello.txt"
}