💎 0

Dashboard

AI Agents

Account

Support

Platform Documentation

Welcome to the BoldTech developer documentation. Here you'll find comprehensive guides and documentation to help you start working with BoldTech as quickly as possible, as well as support if you get stuck.

You can integrate your AI agents directly into your frontend using our pre-built Javascript widgets, or you can build custom backends by communicating directly with our REST API over HTTP.

Authentication

All API requests require authentication. You must include your Agent API Key in the headers of every request.

You can find your API keys in the dashboard under your Agent's Settings page.

Authorization: Bearer YOUR_AGENT_API_KEY

Security Note: Do not share your API keys in publicly accessible areas such as GitHub, client-side code, etc.

Rate Limits & Models

Your rate limits and the underlying AI models are determined by your current billing plan. When you run out of tokens, the API will return a 429 error and the Chatbot widgets will notify users to contact the owner.

PlanModelTokens / Month
FreeLLaMA 3 8B (8k context)50,000
ProMixtral 8x7B (32k context)500,000
PremiumLLaMA 3 70B (8k context)2,000,000 (Unlimited Trial)

UI Widgets (Embed Scripts)

The easiest way to integrate an agent is to drop our widget script into your website. It automatically inherits the Welcome Message, Theme Color, and Name from your agent's dashboard.

Floating Bubble Widget

Places a standard chat bubble in the bottom right corner of your webpage.

<!-- BoldTech Floating Widget --> <script src="https://www.ai.boldtechgh.com/widget.js" data-agent="YOUR_AGENT_UUID" data-mode="bubble"></script>

Simply replace YOUR_AGENT_UUID with your agent's UUID and paste this script right before your closing </body> tag.

Inline Fullscreen Embed

If you want to dedicate a specific part of a page to the chatbot, use the fullscreen mode inside a sized container.

<!-- BoldTech Inline Chat --> <div style="width:100%; height:600px;"> <script src="https://www.ai.boldtechgh.com/widget.js" data-agent="YOUR_AGENT_UUID" data-mode="fullscreen"></script> </div>

REST API Reference

Chat Completions

POST https://www.ai.boldtechgh.com/api/chat

Send a message to your custom trained agent and receive a response generated entirely from your uploaded knowledge bases.

Request Body (JSON)

FieldTypeDescription
agent_idString (UUID)The unique identifier for the agent you are querying.
messageStringThe message / question from the user.

Response Example

{ "success": true, "reply": "Based on the documentation, you can reset your password by...", "tokens_used": 142 }

Code Snippet: cURL

curl -X POST https://www.ai.boldtechgh.com/api/chat \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "agent_id": "YOUR_AGENT_UUID", "message": "Hello, how does pricing work?" }'

Code Snippet: Node.js (Fetch)

const response = await fetch('https://www.ai.boldtechgh.com/api/chat', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ agent_id: 'YOUR_AGENT_UUID', message: 'Hello, how does pricing work?' }) }); const data = await response.json(); console.log(data.reply);

Code Snippet: Python (Requests)

import requests url = "https://www.ai.boldtechgh.com/api/chat" headers = { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" } data = { "agent_id": "YOUR_AGENT_UUID", "message": "Hello, how does pricing work?" } response = requests.post(url, json=data, headers=headers) print(response.json()['reply'])

Get Agent Info

GET https://www.ai.boldtechgh.com/api/agent/{uuid}

Retrieve public metadata for an agent (required to render the chat widget externally, does not require an API key).

Response Example

{ "success": true, "agent": { "name": "Customer Support Bot", "welcome_message": "Hi! How can I help you today?", "theme_color": "#7c6aff" } }

Error Handling

Our API uses standard HTTP status codes and responds with detailed JSON error messages when a request fails.

CodeMeaningDescription
400Bad RequestMissing parameters or malformed JSON.
401UnauthorizedMissing or invalid Authorization header (API Key).
403ForbiddenThe API key doesn't match the requested agent_id.
404Not FoundThe requested Agent UUID does not exist.
429Too Many RequestsYou have exhausted your billing plan's token limit.
500Internal ErrorAn issue occurred connecting to the backend AI models.

Platform Guidelines & Rules

  • No abusive usage: Scraping APIs bypassing rate limits will result in a permanent ban.
  • Token consumption: Tokens are counted based on input document context + user question + generated model response. We run a highly optimized chunking RAG to minimize context injection overhead.
  • Privacy: Document contents are vectorized and stored securely under your tenant boundary. BoldTech DOES NOT use your uploaded data to train our own foundation models.