Lessons

Runtime calibration distills lessons from your calls and their outcomes. These operations read them.

All paths are under https://api.mubit.ai, with a management key in Authorization: Bearer. Management API covers keys, roles, pagination, retries and errors. The samples read the key from MUBIT_MANAGEMENT_KEY.

List lessons

GET /api/v1/lessons

Lists the lessons runtime calibration distilled: rules, pitfalls and guidelines.

Role: read or higher.

curl "https://api.mubit.ai/api/v1/lessons" \
  -H "Authorization: Bearer $MUBIT_MANAGEMENT_KEY"

Response 200: List of lessons

Each item of data:

{
  "data": [
    {
      "id": "les_019283",
      "rule": "Always include tax breakdown in billing responses",
      "status": "active",
      "scope": "global",
      "importance": "high",
      "recurrence_count": 5,
      "created_at": "2026-10-20T00:00:00Z"
    }
  ],
  "next_cursor": null
}

Get a lesson

GET /api/v1/lessons/{lesson_id}

Returns one lesson with its evidence and scope.

Role: read or higher.

curl "https://api.mubit.ai/api/v1/lessons/$LESSON_ID" \
  -H "Authorization: Bearer $MUBIT_MANAGEMENT_KEY"

Response 200: Lesson details

{
  "id": "les_019283",
  "rule": "Always include tax breakdown in billing responses",
  "status": "active",
  "scope": "global",
  "importance": "high",
  "citations": [
    "call_019283",
    "call_019290"
  ]
}