User-related API environment

Pre-live user-related API docs

These pages describe the Pre-live user-related API stack.

Use pre-live OAuth credentials, pre-live API base URLs, and pre-live app URLs when following this documentation. Keep your OAuth flow, API requests, callback URLs, and manual testing within the pre-live environment.

• Use prelive.quran.com for auth-related testing.
• Use prelive.quranreflect.org for Quran Reflect paths where applicable.
• Do not mix production sessions or production user data with pre-live testing.

Edit a comment

Update an existing comment. Only the comment author or admins can edit. Supports body and mentions updates.

Path Parameters

id number required

Unique numeric comment ID to update

application/json

Request Body required

Comment update payload with optional body and mentions

comment object
body string
Possible values: <= 8000 characters
Updated comment body text
mentions object[]
User mentions in the updated comment body
Array [
marker string required
Possible values: Value must match regular expression /{{[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}}}/
userId string required
displayName string required
]

Responses

• 200
• 401
• 404

---

Comment updated successfully

application/json

Schema

Example (from schema)

Example

---

Schema

data object required
id number required
postId number required
authorId string required
parentId number required
isPrivate boolean required
Default value: false
isEdited boolean required
Default value: false
body string required
createdAt date-time required
updatedAt date-time required
toxicityScore number
repliesCount number
Default value: 0
likesCount number
Default value: 0
reported boolean
Default value: false
removed boolean
Default value: false
hidden boolean
Default value: false
moderationEvasionSuspected boolean
Default value: false
languageId number
languageName string
moderationStatus number
author object
postsCount number
avatarUrls object required
small string
medium string
large string
id string required
username string
verified boolean
Default value: false
firstName string
lastName string
memberType number
mentions object[]
Array [
postsCount number
avatarUrls object required
small string
medium string
large string
id string required
username string
verified boolean
Default value: false
firstName string
lastName string
memberType number
locations object required
followersCount number required
displayName string
]
tags object[]
Array [
language string
id number required
name string
commentsCount number
]
success boolean required

{
  "data": {
    "id": 0,
    "postId": 0,
    "authorId": "string",
    "parentId": 0,
    "isPrivate": false,
    "isEdited": false,
    "body": "string",
    "createdAt": "2026-07-10T14:14:33.364Z",
    "updatedAt": "2026-07-10T14:14:33.364Z",
    "toxicityScore": 0,
    "repliesCount": 0,
    "likesCount": 0,
    "reported": false,
    "removed": false,
    "hidden": false,
    "moderationEvasionSuspected": false,
    "languageId": 0,
    "languageName": "string",
    "moderationStatus": 0,
    "author": {
      "postsCount": 0,
      "avatarUrls": {
        "small": "string",
        "medium": "string",
        "large": "string"
      },
      "id": "string",
      "username": "string",
      "verified": false,
      "firstName": "string",
      "lastName": "string",
      "memberType": 0
    },
    "mentions": [
      {
        "postsCount": 0,
        "avatarUrls": {
          "small": "string",
          "medium": "string",
          "large": "string"
        },
        "id": "string",
        "username": "string",
        "verified": false,
        "firstName": "string",
        "lastName": "string",
        "memberType": 0,
        "locations": {},
        "followersCount": 0,
        "displayName": "string"
      }
    ],
    "tags": [
      {
        "language": "string",
        "id": 0,
        "name": "string",
        "commentsCount": 0
      }
    ]
  },
  "success": true
}

{
  "data": {
    "id": 1,
    "postId": 1,
    "authorId": "string",
    "parentId": 1,
    "isPrivate": false,
    "isEdited": false,
    "body": "string",
    "createdAt": "2026-04-02T00:00:00.000Z",
    "updatedAt": "2026-04-02T00:00:00.000Z",
    "toxicityScore": 1,
    "repliesCount": 0,
    "likesCount": 0,
    "reported": false,
    "removed": false,
    "hidden": false,
    "moderationEvasionSuspected": false,
    "languageId": 1,
    "languageName": "string",
    "moderationStatus": 1,
    "author": {
      "postsCount": 1,
      "avatarUrls": {
        "small": "string",
        "medium": "string",
        "large": "string"
      },
      "id": "string",
      "username": "string",
      "verified": false,
      "firstName": "string",
      "lastName": "string",
      "memberType": 1
    },
    "mentions": [
      {
        "postsCount": 1,
        "avatarUrls": {
          "small": "string",
          "medium": "string",
          "large": "string"
        },
        "id": "string",
        "username": "string",
        "verified": false,
        "firstName": "string",
        "lastName": "string",
        "memberType": 1,
        "locations": {},
        "followersCount": 1,
        "displayName": "string"
      }
    ],
    "tags": [
      {
        "language": "string",
        "id": 1,
        "name": "string",
        "commentsCount": 1
      }
    ]
  },
  "success": true
}

User not authenticated

Comment not found

Loading...