B.O.O.B.I.E.™ API Reference

Welcome to the official boobie.ai developer documentation. The B.O.O.B.I.E.™ platform gives you programmatic access to AI automation, intelligent workflows, data pipelines, and agent orchestration — all built for enterprise and creator ecosystems.

Quickstart

Get your first automation running in under 5 minutes. Install the SDK, authenticate, and trigger your first workflow.

Step 1 — Install the SDK

# Python
pip install boobie-ai

# JavaScript / Node.js
npm install @boobie-ai/sdk

# Go
go get github.com/boobie-ai/sdk-go

Step 2 — Initialize the Client

from boobie_ai import BooobieClient

client = BooobieClient(api_key="YOUR_API_KEY")

# Test your connection
status = client.ping()
print(status)  # {"status": "ok", "environment": "production"}

Step 3 — Trigger Your First Automation

workflow = client.workflows.trigger(
    workflow_id="wf_your_workflow_id",
    inputs={
        "data_source": "crm",
        "action": "sync_contacts",
        "notify": True
    }
)

print(workflow.status)   # "running"
print(workflow.run_id)   # "run_abc123xyz"

Authentication

All requests to the B.O.O.B.I.E.™ API require a valid API key passed in the request header. Never expose your API key in client-side code.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

API Key Scopes

• read — Read-only access to resources and run history
• write — Create and update workflows, automations, and agents
• execute — Trigger workflow runs and agent tasks
• admin — Full access including billing and team management

Environments

boobie.ai provides two fully isolated environments. Use sandbox for development and testing at no cost. Switch to production for live deployments.

Automation API

The Automation API lets you programmatically build, trigger, and manage AI-powered workflow automations across any connected system.

automation = client.automations.create(
    name="Daily CRM Sync",
    trigger={"type": "schedule", "cron": "0 9 * * *"},
    steps=[
        {"action": "fetch_data", "source": "salesforce"},
        {"action": "transform", "map": "contact_schema"},
        {"action": "push", "destination": "hubspot"}
    ]
)
print(automation.id)  # "auto_xyz789"

Intelligence API

Query the B.O.O.B.I.E.™ intelligence layer for real-time analytics, predictive insights, and data pipeline results.

result = client.intelligence.query(
    question="What are my top 10 customers by revenue this quarter?",
    data_source="warehouse",
    format="table"
)
print(result.answer)
print(result.data)   # Structured table response

Workflow API

The Workflow API orchestrates complex multi-step processes across teams, tools, and systems with built-in error handling, retries, and audit logging.

Agent API

Deploy, configure, and communicate with B.O.O.B.I.E.™ AI agents — autonomous workers that learn, adapt, and handle tasks on your behalf.

SDKs & Libraries

Official SDKs are available for the most popular languages and frameworks. All SDKs are open source, regularly maintained, and fully typed.

Webhooks

Subscribe to real-time events from the B.O.O.B.I.E.™ platform. Webhooks are delivered as HTTP POST requests to your endpoint with a signed payload.

Available Events

• workflow.completed — A workflow run finished successfully
• workflow.failed — A workflow run encountered an error
• agent.task_completed — An agent finished an assigned task
• automation.triggered — An automation was triggered
• alert.fired — An intelligence alert threshold was crossed

import hmac, hashlib

def verify_webhook(payload, signature, secret):
    expected = hmac.new(
        secret.encode(), payload, hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(f"sha256={expected}", signature)

Rate Limits

Rate limits are applied per API key, per minute. Exceeding the limit returns a 429 Too Many Requests response.

Error Codes

All API errors return a JSON object with a code, message, and optional details field.

Changelog

v1.0.0 — June 2026

• Initial release of the B.O.O.B.I.E.™ API platform
• Automation API, Intelligence API, Workflow API, and Agent API launched
• SDKs available for Python, JavaScript, TypeScript, Java, Go, and .NET
• Sandbox environment with full feature parity to production
• Webhooks for all major platform events
• SOC 2 Type II compliance achieved