API Reference
Backoffice APIs
Gigantea

Gigantea API Reference

Overview

The Gigantea API provides endpoints for submitting and analyzing user feedback in the TKM AI Agency Platform.

Base URL

/api/feedback

Endpoints

Submit Feedback

POST /submit

Submit and process user feedback.

Request Body

{
    "user_id": "string",
    "organization_id": "string",
    "feedback_type": "string",
    "rating": "number",
    "title": "string",
    "comment": "string"
}

Response

{
    "success": true,
    "message": "Feedback received and processed",
    "feedback_id": "string"
}

Get Feedback Statistics

GET /stats

Retrieve feedback statistics and analytics.

Response

{
    "success": true,
    "stats": {
        "total_feedback": "number",
        "sentiment_distribution": {},
        "category_distribution": {},
        "average_rating": "number"
    }
}

Error Responses

500 Internal Server Error

{
    "detail": "Gigantea agent not initialized" | "Error message"
}

Integration Notes

Feedback Processing

  • LLM-powered analysis
  • Sentiment analysis
  • Category classification
  • Priority assessment
  • Summary generation

Data Management

  • Feedback storage
  • Statistics tracking
  • Historical analysis
  • Trend identification

Event System

  • Feedback submission events
  • Analysis completion notifications
  • Email coordination
  • Limit checking

Integration with Other Agents

  • Alfari: LLM configuration
  • Lyra: Email notifications
  • Niger: Data persistence
  • Gulosa: User verification
AlfariMessor