Workspace API overview

The Workspace API lets you use MixerLead programmatically — run chats, generate marketing intel, manage your knowledge base, execute skills, and run agents from your own apps, scripts, and workflows.

Base URL

https://ai.mixerlead.com/api

All endpoints are relative to this base. Requests and responses use JSON (Content-Type: application/json), unless noted otherwise.

Authentication

Authenticate every request with a workspace API key as a Bearer token:

Authorization: Bearer ml_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Keys are created by workspace admins in the app. See Authentication for how to create, use, and rotate keys.

A first request

curl https://ai.mixerlead.com/api/ai/models \
  -H "Authorization: Bearer $MIXERLEAD_API_KEY"

This returns the models available to your workspace’s plan.

What you can do

Chat & models Send chat messages and list available models.

Marketing Intel Generate intel and manage competitor monitoring.

Knowledge Add, list, re-index, and delete knowledge sources.

Skills & agents Run skills, manage agents, and save artifacts.

Conventions

Scope to a project (optional). Add an X-Project-Id header to target a specific project. Without it, requests use your workspace’s default project.
Authorization. API keys act with workspace admin privileges.
Rate limits. The API shares your plan’s rate limits and quotas. Handle 429 responses with backoff — see Errors & rate limits.
Idempotency. Treat create calls as non‑idempotent; avoid blind retries on success‑unknown unless the endpoint says otherwise.

Security

Send keys only over HTTPS, from server‑side code.
Never embed an API key in a browser, mobile app, or public repository.
Rotate keys you suspect are exposed. See Authentication and Security & trust.

Authentication Create and manage API keys.

Errors & rate limits Status codes and retry guidance.

Usage & limits Plan limits that apply to the API.