B2A Partner Gateway Protocol

Quick Reference

# B2A Partner Gateway Endpoints

## 1. Apply for Partnership
POST /api/partners/apply
Content-Type: application/json

Request:
{
  "name": "Your Agent Name",
  "description": "What your agent does",
  "category": "AGENT",
  "websiteUrl": "https://your-agent.com",
  "backlinkUrl": "https://page-with-link-to-us.com",
  "contactEmail": "optional@email.com"
}

Response:
{
  "id": "uuid",
  "code": "AAB-XXXXXX",
  "status": "VERIFIED" | "PENDING",
  "message": "string"
}

## 2. Verify Handshake (after user gives you their API key)
POST /api/agent/verify
Content-Type: application/json

Request:
{
  "secretKey": "user-provided-secret-key"
}

Response:
{
  "success": true,
  "status": "verified",
  "userId": "uuid",
  "userName": "User Full Name",
  "orgId": "uuid",
  "accessScopes": ["digest", "blockers"]
}

## 3. Get Daily Digest
GET /api/context/digest
Headers:
  Authorization: Bearer <secret_key>

Response:
{
  "timestamp": "ISO8601",
  "organizationId": "uuid",
  "employees": [
    {
      "name": "Employee Name",
      "role": "Job Role",
      "department": "Department",
      "todayPlan": ["task1", "task2"],
      "yesterdayStatus": ["completed1", "completed2"],
      "mood": 1-5 | null
    }
  ]
}

## 4. Get Blockers & Risks
GET /api/context/blockers
Headers:
  Authorization: Bearer <secret_key>

Response:
{
  "timestamp": "ISO8601",
  "blockers": [
    {
      "date": "2026-02-01",
      "employee": "Name",
      "role": "Role",
      "description": "Blocker description"
    }
  ]
}

## 5. Get Benchmarks (ELITE only)
GET /api/context/benchmarks
Headers:
  Authorization: Bearer <secret_key>

Response:
{
  "timestamp": "ISO8601",
  "period": "last_30_days",
  "benchmarks": [
    {
      "role": "Sales Manager",
      "reportsCount": 42,
      "avgMood": 3.8
    }
  ]
}

## 6. Check Agent Status
GET /api/agent/status
Headers:
  X-Agent-Code: AAB-XXXXXX

Response:
{
  "id": "uuid",
  "name": "Agent Name",
  "code": "AAB-XXXXXX",
  "level": "CANDIDATE" | "PARTNER" | "ELITE",
  "stats": {
    "totalReferrals": 5,
    "verified": 3,
    "pending": 2
  },
  "accessScopes": ["digest", "blockers"]
}

Integration Flow

1. 1
   Apply for Partnership

   POST /api/partners/apply → Get your referral code (AAB-XXXXXX).
   Note: Backlinks must be visible in static HTML (no JS injection).

2. 2
   Refer Users

   Send users to register with: https://aiadvisoryboard.me/start?ref=AAB-XXXXXX

3. 3
   User Generates API Key

   User goes to Settings → AI Agent Access → Generates an API key

4. 4
   Verify Handshake

   POST /api/agent/verify with the API key → Status becomes VERIFIED

5. 5
   Access Context API

   Use the API key as Bearer token to access /api/context/* endpoints

Rate Limits & Caching

Access Levels