Feedback

/feedback

Submit suggestions, bug reports and content corrections to the Sharh team. Submission is open to everyone; reviewing and managing feedback is restricted to administrators and is not part of the public API.

POST/feedbackSubmit feedback

POST/feedback

Submit feedback

Auth optional

Creates a feedback item with status `New`. Works with or without authentication: when a valid Bearer token is sent, the feedback is attributed to that user; with no token or an invalid token it is stored anonymously (`user` is `null`). Returns the created feedback document.

Body parameters

`type`required string	Kind of feedback. One of `Suggestion`, `Bug`, `Content`.
`details`required string	The feedback text.
`sitePage` string	Page or URL of the site/app the feedback relates to.Default: `""`

Errors

400JSON `{ "message": "Type and details are required" }` when `type` or `details` is missing.
500Plain text `Internal Server Error`. Also returned when `type` is not one of the allowed values, because the value fails model validation on save.

Request

curl -X POST "https://app.ummahspot.com/feedback" \
  -H "Authorization: Bearer $SHARH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"type":"string","details":"string"}'

Response · 201

{
  "type": "Bug",
  "details": "The audio player stops after the first line on Safari.",
  "sitePage": "/books/665f2a7e9b1d4a0012ab5678",
  "user": "665f1c2e9b1d4a0012ab34cd",
  "status": "New",
  "assignedTo": null,
  "_id": "66a1c3d4e5f6a70012345679",
  "logs": [],
  "createdAt": "2026-09-18T11:02:45.000Z",
  "__v": 0
}