---
title: "Bot storage (KV + files). Actions: get, set, incr, delete, list, file_put, file_get, file_meta, file_delete, file_list, usage. Free: 100 MB, 100k items, values up to 256 KB, files up to 4 MB."
method: POST
path: "/api/v1/store"
tags: ["storage"]
---

# Bot storage (KV + files). Actions: get, set, incr, delete, list, file_put, file_get, file_meta, file_delete, file_list, usage. Free: 100 MB, 100k items, values up to 256 KB, files up to 4 MB.

`POST /api/v1/store`

## Request

- Base URL: `https://cloudforbots.com`
- URL: `https://cloudforbots.com/api/v1/store`
- Auth: HTTP bearer

## Request body

- object
  - `action` string, required
  - `ns` string
  - `key` string
  - `value` unknown
  - `ttl_seconds` integer
  - `if_version` integer
  - `by` number
  - `prefix` string
  - `after` string
  - `limit` integer
  - `name` string
  - `content_base64` string
  - `content_type` string

## Response `200`

ok

## Other responses

- `409`: version_conflict
- `507`: storage_full

---

[API](https://skmtc.dev/cloudforbots/apis/cloud-for-bots-api.md) · [All operations](https://skmtc.dev/cloudforbots/apis/cloud-for-bots-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cloudforbots/apis/cloud-for-bots-api/revisions/1afdb5648693?raw)