API Reference

Interact with Caibre and North programmatically. Our REST API is built to handle stateful accounting conversations with context-awareness.

Authentication

Access is managed via session cookies. No API keys are required for student-level access, but the JSESSIONID must be present in request headers.

POST

/api/chat

Primary interface for Caibre (Admin). Best for administrative flow, venue data, and policy clarifications.

Body Parameters

message string Required
POST

/api/chat/north

Specialized tutor endpoint for North (ACC101). Used for academic tutoring and conceptual breakdowns.

REQUEST EXAMPLE CURL 
curl -X POST https://api.ubuntu.com/chat \
  -H "Content-Type: application/json" \
  -d '{ "message": "What are my marks?" }'
RESPONSE JSON 
{
  "response": "Your current avg is 68%.",
  "success": true
}
NORTH REQUEST 
{
  "message": "Explain FIFO vs LIFO"
}