Brainshop.ai API

Name: Brainshop.ai API
Brand: Brainshop.ai API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentAI/MLLanguage ModelsapiKey1 EndpointsREST

For Agents

Send a user message to a Brainshop AI brain and get back an intelligent text response, with conversation state tracked per user ID.

Install Jentic One Beta

Connect the Brainshop.ai API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Brainshop.ai API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Brainshop.ai API.

Send a user message to a Brainshop AI brain via GET /get and receive a generated reply

Maintain per-user conversation context by passing a stable uid query parameter on each call

Route messages to a specific brain configuration using the bid (brain ID) parameter

GET STARTED

Start building with Brainshop.ai API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI specification for Brainshop.ai API, keeping it validated and agent-ready. Brainshop.ai is a chatbot platform that lets developers send a user message to a configured AI brain and receive a natural-language reply, with conversation context maintained per user identifier. The service is exposed through a single GET /get endpoint that takes a brain ID, API key, user ID, and message as query parameters. It suits lightweight chatbot integrations in messaging apps, support widgets, and prototype assistants where a hosted NLP brain is preferable to running a local model.

Use Cases

Patterns agents use Brainshop.ai API for, with concrete tasks.

★ Customer support chatbot widget

Embed a lightweight support assistant on a website by forwarding visitor messages to a Brainshop brain and rendering the reply in a chat bubble. Each visitor session uses a stable uid so the brain keeps multi-turn context across messages. This avoids hosting a local language model and keeps integration to a single GET request per turn.

Call GET /get with bid=178, key={API_KEY}, uid=visitor_42, msg=What are your business hours? and return the cnt field from the JSON response.

Messaging-app conversational bot

Bridge a messaging platform like Telegram, Discord, or Slack to a Brainshop brain by forwarding inbound user messages to GET /get and posting the reply back to the channel. Using the platform user ID as uid preserves conversational state per person across sessions.

On every inbound message in Discord, call GET /get with bid={BRAIN_ID}, uid={discord_user_id}, msg={message_text} and post the reply text back to the channel.

Prototype assistant for product validation

Stand up a working conversational prototype in hours rather than days by pointing a frontend at Brainshop instead of training or hosting a model. Useful for validating chatbot UX, scripting demo flows, or running internal pilots before committing to a full LLM stack.

Wire a React form input to GET /get with a fixed bid and uid, then display the returned cnt field below the input as the assistant reply.

AI agent integration via Jentic

An agent that needs to ask a hosted conversational brain a question can discover Brainshop through Jentic search, load the schema for the sendMessage operation, and execute it without storing the API key in agent memory. Jentic handles credential isolation and parameter validation.

Through Jentic, search for 'send a message to a chatbot brain', load the sendMessage operation, and execute it with the brain ID and user message supplied by the caller.

Key Endpoints

1 endpoints — jentic publishes the only available openapi specification for brainshop.

METHOD

PATH

DESCRIPTION

GET

/get

Send a message to a Brainshop AI brain and receive an intelligent reply

GET

/get

Send a message to a Brainshop AI brain and receive an intelligent reply

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

The Brainshop API key is stored encrypted in the Jentic vault and injected as the key query parameter only at execution time. Agents call sendMessage by intent, never see the raw key, and key rotation happens centrally without redeploying agent code.

Intent-based discovery

Agents search Jentic for intents like 'send a message to a chatbot brain' and Jentic returns the Brainshop sendMessage operation with its bid, uid, and msg parameter schema, so the agent can call it without browsing brainshop.ai docs.

Time to first call

Direct Brainshop integration: a few hours to wire query parameters, error handling, and key storage. Through Jentic: under 15 minutes — search, load, execute.

FAQs

Specific to using Brainshop.ai API through Jentic.

Why is there no official OpenAPI spec for Brainshop.ai API?

Brainshop.ai does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Brainshop.ai API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the Brainshop.ai API use?

The API uses a simple API key passed as the key query parameter on GET /get, alongside the brain ID (bid). Jentic stores the key in its credential vault and injects it at execution time, so the raw key is never exposed to agent prompts or logs.

How do I keep conversation context across turns with the Brainshop.ai API?

Pass a stable uid query parameter on every call to GET /get. The brain associates messages with that uid to preserve dialogue state, so reuse the same uid for the same end user across turns and start a new uid for a new conversation.

What are the rate limits for the Brainshop.ai API?

The OpenAPI spec does not declare rate limits. Brainshop applies per-brain limits tied to the plan attached to your bid; check your account at brainshop.ai for current quotas before high-volume use.

How do I send a chatbot message with the Brainshop.ai API through Jentic?

Search Jentic for 'send a message to a chatbot brain', load the sendMessage operation, then execute with bid, uid, and msg. Install with pip install jentic and use the async pattern: await client.search, await client.load, await client.execute.

Is the Brainshop.ai API free?

Brainshop.ai offers a free tier sufficient for prototyping with a single brain and limited daily traffic. Paid plans on brainshop.ai raise the request quota and unlock additional brain configurations.