Developer ResourcesSupport
Support Requests Admin API Reference
Integration reference for admin support request endpoints.
Support Requests Admin API Reference
Audience: Admin/frontend developers, API consumers Scope: Admin support request contracts currently implemented.
Admin APIs
List Support Requests
Endpoint
GET /api/admin/support-requestsAuth
Authorization: Bearer <admin-jwt>- Requires admin permission:
SupportRequests_READ
Query params
| Param | Type | Required | Example | Notes |
|---|---|---|---|---|
status | string | No | open | open, in_progress, resolved, closed |
category | string | No | technical | account, payment, technical, other |
customerId | string | No | uuid | Filter by customer |
assignedAdminId | string | No | uuid | Filter by assignee |
search | string | No | login | Matches subject |
page | number | No | 1 | Default 1 |
size | number | No | 20 | Default 20, max 100 |
Get Support Request Detail
Endpoint
GET /api/admin/support-requests/{id}Returns support metadata plus chronological message thread.
Response (messages shape)
{
"message": "Support request fetched successfully",
"data": {
"id": 1,
"customerId": "customer-uuid",
"category": "technical",
"subject": "App crashes on checkout",
"status": "in_progress",
"assignedAdminId": "admin-uuid",
"resolutionNote": null,
"resolvedAt": null,
"closedAt": null,
"lastCustomerMessageAt": "2026-03-17T10:05:00.000Z",
"lastAdminMessageAt": "2026-03-17T10:06:00.000Z",
"messages": [
{
"id": 10,
"supportRequestId": 1,
"authorType": "customer",
"authorCustomerId": "customer-uuid",
"authorAdminId": null,
"authorName": "Alex Customer",
"authorImage": "https://cdn.example.com/customer.png",
"body": "App crashes on checkout.",
"createdAt": "2026-03-17T10:04:00.000Z"
},
{
"id": 11,
"supportRequestId": 1,
"authorType": "admin",
"authorCustomerId": null,
"authorAdminId": "admin-uuid",
"authorName": "Support Agent",
"authorImage": "https://cdn.example.com/admin.png",
"body": "Thanks, we are looking into it.",
"createdAt": "2026-03-17T10:06:00.000Z"
}
],
"createdAt": "2026-03-17T10:00:00.000Z",
"updatedAt": "2026-03-17T10:06:00.000Z"
}
}Update Support Status
Endpoint
PATCH /api/admin/support-requests/{id}/statusAuth
- Requires admin permission:
SupportRequests_UPDATE
Request body
{
"status": "resolved",
"resolutionNote": "Customer confirmed the issue is fixed."
}Rules:
resolutionNoteis only valid forresolvedorclosed- mobile user replies are blocked once status becomes
closed
Assign Support Request
Endpoint
PATCH /api/admin/support-requests/{id}/assignRequest body
{
"assignedAdminId": "admin-uuid"
}Send null to clear assignment.
Add Admin Reply
Endpoint
POST /api/admin/support-requests/{id}/messagesRequest body
{
"body": "We are reviewing this issue now."
}