Skip to main content

​
Overview

The Feedback Management APIs provide comprehensive functionality for collecting user feedback, managing feedback items, tracking responses, and analyzing feedback trends across all TalentG platform features.

​
Base URL

https://talentg.io/api

​
Authentication

Feedback APIs require authentication. Access levels vary based on operation type and user roles. 
Authorization: Bearer <supabase_jwt_token>
Content-Type: application/json

​
Feedback Collection

​
Submit Feedback

​
Get User Feedback

​
Admin Feedback Management

​
List All Feedback

​
Respond to Feedback

​
Update Feedback Status

​
Feedback Analytics

​
Feedback Summary

​
Feedback Categories

The system supports the following feedback categories:
CategoryDescriptionResponse SLA
assessmentFeedback about assessments and results24 hours
supportCustomer support experience12 hours
platformPlatform usability and performance48 hours
feature_requestSuggestions for new features72 hours
bug_reportBug reports and technical issues24 hours

​
Priority Levels

Feedback items are automatically prioritized based on:
  • Urgent: Critical bugs, security issues, complete service outages
  • High: Major functionality issues, payment problems
  • Medium: UI/UX issues, feature requests, minor bugs
  • Low: General feedback, suggestions, minor improvements

​
Response Templates

​
Common Response Templates

Bug Acknowledgment: 
Thank you for reporting this issue. Our technical team has been notified and we're investigating. We'll provide an update within 24 hours.
Feature Request: 
Thank you for your feature suggestion! We've added this to our roadmap and will consider it for upcoming releases. We'll keep you updated on our progress.
Positive Feedback: 
Thank you for your positive feedback! We're thrilled to hear about your good experience and will continue working to maintain this level of quality.

​
Error Handling

​
Common Error Codes

CodeHTTP StatusDescription
UNAUTHORIZED401User not authenticated
FORBIDDEN403Insufficient permissions
NOT_FOUND404Feedback item not found
VALIDATION_ERROR400Invalid feedback data
RATE_LIMITED429Too many feedback submissions

​
Error Response Format

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid feedback category",
    "details": {
      "category": "invalid_category",
      "valid_categories": ["assessment", "support", "platform", "feature_request", "bug_report"]
    }
  }
}

​
Rate Limiting

  • Submit feedback: 10 requests per hour per user
  • View own feedback: 100 requests per hour per user
  • Admin operations: 500 requests per hour per user
  • Analytics requests: 200 requests per hour per user

​
SDK Examples

const submitFeedback = async (feedbackData) => {
  const token = await getSupabaseToken();

  const response = await fetch('/api/feedback', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${token}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(feedbackData)
  });

  return response.json();
};

// Usage
const result = await submitFeedback({
  category: 'assessment',
  rating: 5,
  title: 'Great assessment!',
  comment: 'The results were very accurate and helpful.',
  metadata: {
    assessment_type: 'strength_finder'
  }
});

​
Best Practices

​
For Users

  • Provide specific, actionable feedback
  • Include relevant context (browser, device, steps to reproduce)
  • Rate honestly and provide detailed comments
  • Use appropriate categories for faster resolution

​
For Admins

  • Respond promptly according to SLA guidelines
  • Categorize and prioritize feedback appropriately
  • Track action items and follow up on commitments
  • Use feedback insights to drive product improvements

​
Data Collection

  • Respect user privacy preferences
  • Anonymize sensitive information in analytics
  • Implement proper data retention policies
  • Regularly review and act on feedback trends
All feedback responses include automatic email notifications to users. Response times are tracked and reported in analytics.
Feedback containing sensitive personal information should be handled according to your organization’s data protection policies.