Changelog

API changes, new features, and deprecations across all Kapable services.

2026-06-11 — SDK v0.4.2 (TS) / v0.4.1 (Rust)

Native workspace scoping

• TS: new KapableClient({ ..., workspaceId }) sends X-Workspace-Id on every request; per-request override via RequestOptions.workspaceId (null = org-wide opt-out); client.withWorkspace(id) derives a re-scoped client whose sub-clients all carry the scope.
• Rust: KapableClient::new(url).workspace_id(ws) builder option; with_workspace_id / without_workspace_id derive re-scoped clients.

Apps deployments read API

• auth.listDeployments(appId, {limit}) + auth.getDeployment(appId, deploymentId) (TS) / list_deployments + get_deployment (Rust) wrap GET /v1/apps/{app_id}/deployments (+ /{deployment_id}).

Also since 0.2.0

• 0.3.0: client.projects.* + project-bound key mint; workspace/project credential binding; workspace_scoped table creation.
• 0.4.0: workspaces module (CRUD, members, single-use invitations, custom roles, org audit), per-record read-only shares, simulate — "principal sees N of M rows" via the real RLS engine.
• 0.4.1 (TS): Node-compatible ESM dist/ — the package now imports cleanly in both Node and Bun (dual-runtime clean-room gate).

2026-06-09 — SDK v0.2.0, canonical API host, operator SDK

api.kapable.ai is live

• One canonical base URL. https://api.kapable.ai now fronts all customer-tier services with /v1/* path routing — the base URL the SDKs always documented finally resolves.
• Self-service credentials verified end-to-end: signup → mint key (POST /v1/auth/api-keys, secret shown once) → authenticated 200.
• AI-readable docs published: llms.txt + llms-full.txt (352 endpoints, generated from the SDK coverage manifest).

SDK v0.2.0 published (npm + cargo)

• @kapable/sdk@0.2.0 — 13 modules, 324 methods (was 7 modules at 0.1.0). New: ai, secrets, billing, wiki, harbor, warrant, security types.
• kapable-sdk@0.2.0 (cargo) — full TypeScript parity (315 methods) including a new SSE module.
• New: operator SDK. @kapable/ops-sdk@0.1.0 + kapable-ops-sdk@0.1.0 wrap the berth/foreman/host/gateway/admin tier; customer keys rejected at construction. See Operator SDK.
• Cargo registry now live (anonymous read): sparse+https://git.kapable.dev/api/packages/kapable/cargo/.
• Fixed from 0.1.0: 4 phantom org-repo methods (404 at runtime), 6 wrong-path Rust knowledge methods, Rust↔TS drift in every module. 0.1.0 remains installable but is deprecated — upgrade.

Docs

• This site moved to docs.kapable.ai; quickstart rewritten around the verified golden path (note: org_slug is required on signup).
• Honest scope documentation: what an sk_live_ key can and cannot reach today (see Authentication).

2026-05-20 — SDK v0.1.0

TypeScript & Rust SDKs Published

• Published @kapable/sdk@0.1.0 to Forgejo npm registry — 7 modules, 176+ methods
• Published kapable-sdk@0.1.0 to Forgejo cargo registry — 6 modules, 140 methods
• SSE real-time module added to TypeScript SDK with auto-reconnection
• API docs site deployed at docs.kapable.dev

Install

# TypeScript (add .npmrc first: @kapable:registry=https://git.kapable.dev/api/packages/kapable/npm/)
bun add @kapable/sdk

# Rust (add to .cargo/config.toml: [registries.kapable] index = "sparse+https://git.kapable.dev/api/packages/kapable/cargo/")
cargo add kapable-sdk --registry kapable

API Documentation Site

• Launched unified API documentation site covering all five services
• Added TypeScript SDK examples for every endpoint
• Dark/light mode, responsive design, code copy buttons

2026-05-15

Comms

• Added per-mailbox quota overrides (GET/PUT/DELETE /v1/mailboxes/{id}/quotas)
• Added anomaly SSE feed (GET /v1/orgs/{org_id}/anomaly-feed)
• MCP transport endpoint for agent onboarding (POST /v1/mcp/{token})

Knowledge

• Added reversible merges -- unmerge endpoint for canonical entities
• Predicate ontology lookup (GET /v1/knowledge/predicates/{name}/ontology)
• Provenance graph BFS (GET /v1/knowledge/sources/{id}/provenance-graph)

2026-04-28

Board

• Added Products resource (/v1/board/products)
• Added Comments resource with target_type scoping
• Sprint closures for retrospectives and release notes

Data

• SSE change streams (GET /v1/sse) for real-time table notifications
• Full-text search endpoint (POST /v1/{table}/search)
• CSV import and JSON export endpoints

2026-04-01

Platform

• Unified error response format across all services (kv2-core)
• Cursor-based and offset pagination standardized
• Health endpoints now probe database pools (not static "ok")

Store

• Presigned URLs with external endpoint support
• HEAD endpoint for object metadata

2026-03-15

Initial Release

• Board API: stories, sprints, plans
• Store API: buckets, objects
• Data API: tables, row CRUD, bulk operations
• Comms API: agents, mailboxes, channels, messages, rooms
• Knowledge API: sources, pages, claims, edges, predicates
• TypeScript SDK (@kapable/sdk) with typed clients

Next

Getting Started · Authentication