Skip to content

Support Operations Module

Overview

Support ticketing and FAQ operations for customer and internal support teams.

API Prefix: /api/v1/support

Route Verification Status

  • Source Router: app/api/v1/endpoints/support.py
  • Live Route Count: 12
  • Verification State: Verified (2026-06-28)
  • Canonical Tracking: docs/API_ROUTE_DOCUMENTATION_TODO.md
  • Verification Method: Route decorators extracted from @r.<method>(...) in app/api/v1/endpoints/support.py.

API Endpoints (Verified Against Live Router)

For the complete support endpoint inventory (method, effective path, source line), use: - docs/API_ROUTE_LIVE_REFERENCE.md -> section support.py (12 routes)

Permission Dependency Notes (Verified)

Confirmed explicit permission checks in support.py include: - Ticket administration: manage_support_tickets.

Operational note: - Some support routes currently include empty placeholders (permission_required("")) and should be made explicit.

Standard Error Response Matrix

{
    "status_code": 400,
    "error_code": "SUPPORT_ERROR",
    "message": "Human-readable summary",
    "details": {}
}

Common mappings: - 400 invalid ticket action or payload. - 401 unauthenticated request. - 403 permission denied. - 404 ticket/faq resource not found. - 409 conflicting ticket state transition. - 422 schema validation failure. - 429 throttled request. - 500 internal processing error.