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.

Plan	Model	Tokens / Month
Free	LLaMA 3 8B (8k context)	50,000
Pro	Mixtral 8x7B (32k context)	500,000
Premium	LLaMA 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://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://ai.boldtechgh.com/widget.js"
            data-agent="YOUR_AGENT_UUID"
            data-mode="fullscreen"></script>
</div>

WordPress Plugin

Easily embed your BoldTech AI agent into any WordPress site using our official plugin. The plugin is pre-configured with your agent's UUID when downloaded from the dashboard.

Download

Navigate to your Agent Details page in the dashboard and click Download WordPress Plugin. A ZIP file containing the plugin with your agent's UUID pre-filled will be generated.

Installation

In your WordPress admin, go to Plugins → Add New → Upload Plugin.
Choose the downloaded ZIP file and click Install Now.
Click Activate.

Configuration

After activation, go to Settings → BoldTech AI in your WordPress admin.

Field	Description
`Agent ID`	Your agent's UUID (pre-filled if downloaded from the dashboard).
`Platform URL`	Your BoldTech platform URL (pre-filled).
`Display Mode`	Choose Floating Bubble (appears on all pages) or Shortcode (place manually).
`Enable`	Toggle the widget on or off site-wide.

Usage

Floating Bubble mode — The chat bubble appears on all pages automatically when enabled.

Shortcode mode — Place the shortcode on any page or post:

[boldtech_agent]

You can override settings per-page:

[boldtech_agent agent_id="ANOTHER_UUID" mode="fullscreen"]

Updating

Re-download the ZIP from your agent dashboard and re-upload via Plugins → Add New → Upload Plugin. Your saved settings will be preserved.

REST API Reference

Chat Completions

POST https://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)

Field	Type	Description
`agent_id`	String (UUID)	The unique identifier for the agent you are querying.
`message`	String	The 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://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://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://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'])

Code Snippet: PHP (cURL)

<?php
$ch = curl_init('https://ai.boldtechgh.com/api/chat');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'agent_id' => 'YOUR_AGENT_UUID',
        'message' => 'Hello, how does pricing work?',
    ]),
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
$data = json_decode($response, true);
echo $data['reply'] ?? 'Error';
?>

Code Snippet: JavaScript (Axios)

const axios = require('axios');

const response = await axios.post('https://ai.boldtechgh.com/api/chat', {
    agent_id: 'YOUR_AGENT_UUID',
    message: 'Hello, how does pricing work?'
}, {
    headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    }
});

console.log(response.data.reply);

Get Agent Info

GET https://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.

Code	Meaning	Description
`400`	Bad Request	Missing parameters or malformed JSON.
`401`	Unauthorized	Missing or invalid `Authorization` header (API Key).
`403`	Forbidden	The API key doesn't match the requested `agent_id`.
`404`	Not Found	The requested Agent UUID does not exist.
`429`	Too Many Requests	You have exhausted your billing plan's token limit.
`500`	Internal Error	An 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.