# Butterbase API

**Canonical:** https://apis.io/apis/butterbase-ai/butterbase-ai-api/  
**Provider:** Butterbase — https://apis.io/providers/butterbase-ai/  
**Base URL:** https://api.butterbase.ai  
**Documentation:** https://docs.butterbase.ai/api-reference/ai-api

Butterbase API is one of 2 APIs that [Butterbase](https://apis.io/providers/butterbase-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Butterbase API as documented publicly: 48 operations. Contract generated from the documentation by API Evangelist (2026-11-03); not the provider's own document.

## Operations (48)

| Method | Path | Summary |
|---|---|---|
| GET | `/abc-defg-hij` | GET /abc-defg-hij |
| POST | `/api-keys` | Create a personal API key |
| GET | `/v1` | GET /v1 |
| POST | `/v1` | POST /v1 |
| DELETE | `/v1/{appId}/kv/{key}` | Delete key. |
| GET | `/v1/{appId}/kv/{key}` | Read the value stored at key. |
| PUT | `/v1/{appId}/kv/{key}` | Create or overwrite key. |
| POST | `/v1/{appId}/kv/{key}/cas` | Compare-and-swap: atomically replace the value of key only when the current value equals expected. |
| POST | `/v1/{appId}/kv/{key}/decr` | Atomically decrement a numeric counter. |
| GET | `/v1/{appId}/kv/{key}/exists` | Check whether key exists without fetching its value. |
| POST | `/v1/{appId}/kv/{key}/expire` | Update (or remove) the TTL on an existing key without changing its value. |
| POST | `/v1/{appId}/kv/{key}/incr` | Atomically increment a numeric counter stored at key. |
| POST | `/v1/{appId}/kv/{key}/setnx` | Set key only if it does not already exist (“set if not exists”). |
| GET | `/v1/{appId}/kv/{key}/ttl` | Return the remaining TTL of key in seconds. |
| POST | `/v1/{appId}/kv/_batch` | Execute up to 100 get, set, or del operations in a single round-trip. |
| DELETE | `/v1/{appId}/kv/_expose/{pattern}` | Remove an expose rule. |
| PUT | `/v1/{appId}/kv/_expose/{pattern}` | Create or update an expose rule. |
| POST | `/v1/{appId}/kv/_flush` | Delete all keys belonging to the app. Irreversible. |
| GET | `/v1/ai/meetings` | List bots |
| POST | `/v1/ai/meetings` | Start a bot |
| DELETE | `/v1/ai/meetings/{botId}` | Stop a bot |
| GET | `/v1/ai/meetings/{botId}` | Get bot status + artifact URLs |
| GET | `/v1/app_abc123/kv/session/user-42` | Read the value stored at key. |
| PUT | `/v1/app_abc123/kv/session/user-42` | Create or overwrite key. |
| POST | `/v1/chat/completions` | Chat completion |
| POST | `/v1/embeddings` | Generate embeddings |
| GET | `/v1/models` | List available models (OpenAI-shape) |
| GET | `/v1/public/models` | Public model catalog with pricing |
| GET | `/v1/{appId}/ai/config` | Get AI configuration |
| PUT | `/v1/{appId}/ai/config` | Update AI configuration |
| GET | `/v1/{appId}/ai/models` | Choosing a model – discover configured, executable image models |
| GET | `/v1/{appId}/ai/usage` | Get AI usage statistics |
| POST | `/v1/{appId}/chat/completions` | Chat completion (OpenAI-compatible) |
| POST | `/v1/{appId}/embeddings` | Generate embeddings |
| POST | `/v1/{appId}/images/completions` | Submit a generation job |
| GET | `/v1/{appId}/images/completions/{jobId}` | Poll job status |
| GET | `/v1/{appId}/images/completions/{jobId}/content` | Stream the rendered PNG/JPEG |
| GET | `/v1/{appId}/rag/collections` | List collections |
| POST | `/v1/{appId}/rag/collections` | Create collection |
| DELETE | `/v1/{appId}/rag/collections/{name}` | Delete collection |
| GET | `/v1/{appId}/rag/collections/{name}` | Get collection |
| GET | `/v1/{appId}/rag/collections/{name}/documents` | List documents |
| DELETE | `/v1/{appId}/rag/collections/{name}/documents/{documentId}` | Delete document |
| GET | `/v1/{appId}/rag/collections/{name}/documents/{documentId}` | Get document |
| POST | `/v1/{appId}/rag/collections/{name}/ingest` | Ingest document |
| POST | `/v1/{appId}/rag/collections/{name}/query` | Semantic query |
| POST | `/v1/{appId}/videos/completions` | Submit a generation job |
| GET | `/v1/{appId}/videos/completions/{jobId}/content` | Stream the rendered MP4 |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/butterbase-ai/openapi/_ae-authored/butterbase-ai-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/butterbase-ai/json-schema/butterbase-ai-post-v1-appid-images-completions-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/butterbase-ai/json-schema/butterbase-ai-get-v1-appid-images-completions-jobid-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/butterbase-ai/json-schema/butterbase-ai-post-v1-appid-rag-collections-name-query-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/butterbase-ai/json-schema/butterbase-ai-post-v1-ai-meetings-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/butterbase-ai/json-schema/butterbase-ai-post-v1-appid-rag-collections-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/butterbase-ai/json-schema/butterbase-ai-post-v1-ai-meetings-request-schema.json

## Other Butterbase APIs (1)

- [Data API](https://apis.io/apis/butterbase-ai/data-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/butterbase-ai/butterbase-ai-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/butterbase-ai/.