Developer

AIBJJ REST API

Connect your favorite LLM, automation tool, or custom app to your AIBJJ training data. Available to Pro subscribers.

Authentication

All requests require a Bearer token in the Authorization header.

Authorization: Bearer aibjj_your_api_key_here

Endpoints

GET/api/v1/trainingGet training stats & logs

# Response
{
  "user": { "belt": "BLUE", "stripes": 3, "name": "Jesse" },
  "stats": {
    "totalSessions": 142,
    "currentStreak": 7,
    "thisWeek": 4,
    "thisMonth": 18
  },
  "recentLogs": [...]
}

POST/api/v1/trainingLog a training session

# Body
{
  "date": "2026-04-09",      // optional, defaults to today
  "duration": 90,            // minutes, optional
  "notes": "Worked on X-guard sweeps and leg locks",
  "techniques": ["x-guard", "heel-hook"]  // optional
}

# Response
{ "success": true, "log": { "id": "...", "date": "2026-04-09", ... } }

POST/api/v1/coachQuery the AI BJJ coach

# Body
{
  "message": "How do I improve my guard retention?",
  "history": [  // optional conversation history
    { "role": "user", "content": "I keep getting my guard passed" },
    { "role": "assistant", "content": "Let's work on your frames..." }
  ]
}

# Response
{
  "reply": "Guard retention starts with active frames and hip movement..."
}

GET/api/v1/techniquesGet bookmarked techniques

# Response
{ "techniques": [{ "techniqueId": "armbar", "createdAt": "..." }, ...] }

Use with ChatGPT Custom Actions

You can add AIBJJ as a custom action in your ChatGPT GPT. This lets your GPT log training sessions, check your streak, and query your AI coach — all from inside ChatGPT.

openapi: 3.1.0
info:
  title: AIBJJ Training API
  version: 1.0.0
servers:
  - url: https://aibjj.com
paths:
  /api/v1/training:
    get:
      summary: Get training stats
      operationId: getTraining
    post:
      summary: Log a training session
      operationId: logTraining
  /api/v1/coach:
    post:
      summary: Ask the BJJ coach
      operationId: askCoach

Rate Limits

• 100 requests/minute per API key

• 1,000 AI coach requests/day via API

• No limits on training log reads/writes

• Contact us for higher limits if you are building something cool