/intelligems-api

Load the Intelligems External API documentation before building integrations.

When to Use This Skill

• Starting to build an API integration for Intelligems
• Creating a health check, monitoring, or reporting script
• Building any automation that uses Intelligems data

Step 1: Read the Documentation (MANDATORY)

Read the bundled documentation file:

references/external-api.md

This contains:

• API overview and capabilities
• Authentication method (intelligems-access-token header)
• All endpoints: experiences-list, experiences/{id}, analytics
• Response structures and available metrics
• Python code examples
• Health check formulas and thresholds
• Slack integration tutorial

Step 2: Check Live Docs (OPTIONAL)

If the bundled docs seem outdated or you need additional context, check the live documentation:

1. Main API Docs:

https://docs.intelligems.io/developer-resources/external-api/default

1. Slack Integration Tutorial:

https://docs.intelligems.io/developer-resources/external-api/build-an-automated-test-monitoring-integration-for-slack

Only do this if:

• The user asks to check for updates
• The bundled docs are missing information needed for the use case
• Building something not covered in the bundled docs

Step 3: Confirm Ready

After reading the documentation, confirm you're ready:

"Got it. I've loaded the Intelligems External API context:
- Base URL: https://api.intelligems.io/v25-10-beta
- Auth: intelligems-access-token header
- Key endpoints: experiences-list, experiences/{id}, analytics/resource/{id}

What are we building?"

Quick Reference

Base URL: https://api.intelligems.io/v25-10-beta

Authentication:

intelligems-access-token: your_api_key_here

Main Endpoints:

Key Metrics (Intelligems Priority):

• netrevenueper_visitor - Revenue/visitor (north star)
• grossprofitper_visitor - Profit/visitor (requires COGS)
• conversion_rate - Conversion rate
• netrevenueper_order - AOV
• n_visitors - Visitors
• n_orders - Orders
• pctrevenuewith_cogs - Check if COGS data exists (0 = no COGS)

Confidence: p2bb = Probability to Beat Baseline (not confidence)

Health Check Thresholds (Intelligems Philosophy):

• MINRUNTIMEDAYS: 10
• MIN_VISITORS: 100
• MIN_ORDERS: 10
• MIN_CONFIDENCE: 80% ("we're not making cancer medicine")

Common Use Cases

When the user wants to build...

Notes

• API is in beta - contact [email protected] for access
• Feature suggestions go to [email protected]
• Python examples are in the bundled documentation