BapStack, with two stacked vinyl records.DEVELOPERSOpen AI dev ↗

SIX TOOLS. ONE MIX.

Build with BapStack.

One place for the suite’s APIs, connections and developer guides.

Early development

BapStack AI currently uses synthetic suite data. Live API plugins need a verified BapStack session and app permissions. No paid model calls are enabled.

Choose your environment

EnvironmentAI URLStatus
Developmentai-dev.bapstack.comSynthetic prototype
Testai-test.bapstack.comPlanned · not deployed
Previewai-preview.bapstack.comPlanned · not deployed
Productionai.bapstack.comReserved · not released

Documentation lives at dev.bapstack.com. Each environment keeps separate data and credentials when activated.

BapStack AI API

Base URL: https://ai-dev.bapstack.com. The prototype issues a Secure, HttpOnly browser session cookie. This is an isolated demo workspace, not BapStack sign-in or permission to access real suite data.

POST requests require Content-Type: application/json and X-BapStack-Request: prototype. Include the same conversation UUID when selecting apps and querying tools. Requests are limited to 16 KB.

GET /api/catalog

List functions for the current workspace and selected app scope. Optional conversationId query parameter.

POST /api/scope

Set one or more authorized apps for a chat. Fields: conversationId (UUID), appIds (non-empty array). Changing scope invalidates pending demo actions.

POST /api/chat

Fields: conversationId (UUID), prompt (1–2,000 characters). Uses a bounded deterministic router. This is not general model reasoning.

POST /api/prepare

Fields: capabilityId, input, optional conversationId. Queries return a result; actions return exact inputs and an expiring review proposal.

POST /api/execute

Fields: proposalId (UUID). Execute a reviewed demo action once. Proposals expire after five minutes and remain bound to the workspace and chat scope.

GET / HEAD /api/audio

Fields: appId, id, conversationId. Only known, scoped audio items. Hosted audio is explicitly synthetic. Supports byte ranges for seeking.

Try a synthetic query

curl --fail --cookie-jar /tmp/bapstack-dev.cookies \
  'https://ai-dev.bapstack.com/api/catalog'

curl --fail --cookie /tmp/bapstack-dev.cookies \
  -H 'Content-Type: application/json' \
  -H 'X-BapStack-Request: prototype' \
  -d '{"conversationId":"7db665f9-88a0-4d7e-887e-f622a9245530","prompt":"Show my samples"}' \
  'https://ai-dev.bapstack.com/api/chat'

Download the AI OpenAPI specification ↗

Connect an API with a plugin

A plugin declares its app, functions, input and output schemas, and query/action behavior. Server-side authorization controls which functions are visible and executable. App selection narrows that access.

  1. Register reviewed server code and schemas.
  2. Resolve the current user’s credential on the server.
  3. Query data, or show exact action parameters for confirmation.
  4. Validate the response and return it as data.

Actions require a short-lived, single-use review. Requests have a timeout and no automatic retries. Plugins must honor cancellation and enforce their own request/response limits. API output never grants permission to call another tool.

PluginHost and the SelectorCrate read adapter are implemented in code. They are not connected to anonymous browser sessions. Shared sign-in and function permissions must be wired before enabling live calls. Never paste access tokens into chat.

SelectorCrate · first suite plugin

Private DEV catalog API. Source contract: authenticated owner-only GET /api/health and GET /api/items. API Gateway requires JWT authorization; the backend also restricts the DEV owner. Anonymous requests are denied.

QUERY selectorcrate-cloud.health

Check a signed-in user’s catalog connection. No input.

QUERY selectorcrate-cloud.items.search

Input: q (text, up to 200 characters), optional kind (recording or release), optional cursor, limit (1–50; default 25).

Returns one page of metadata and a continuation cursor. No audio, automatic pagination, or filesystem paths. This cloud endpoint does not provide BPM/key filtering. Native catalog filtering is a separate integration.

This adapter is tested with mocked API responses. Signed-in end-to-end API acceptance remains pending. Catalog writes/imports are not enabled through the AI plugin.

Across the suite

SelectorCrate

Cloud query adapter implemented. Shared session connection pending.

SampleHoarder

Demo samples and soundboards. Live API plugin pending.

MassiveCue

Demo requests and queue actions. Live API plugin pending.

Waxbridge

Native capture and catalog capabilities discovered. Device bridge pending.

MixtapeBeacon

Demo mixes and broadcast drafts. Live API plugin pending.

LinkUp Promoter

Demo gig and campaign tools. Live API plugin pending.