Bulk Update Review Status

Endpoint to update the status of multiple reviews in a single request

Request Example

curl --request POST 'https://api.mayar.id/hl/v2/reviews/bulk-status/update' \
--header 'Authorization: Bearer Paste-Your-API-Key-Here' \
--data-raw '{
    "input": [
        {
            "id": "11f4d767-4d88-41ff-8777-06564d906fe7",
            "paymentLinkId": "e2b3f5d5-0c62-47ba-8a01-6c1c209e0f77",
            "status": "ARCHIVED"
        },
        {
            "id": "a1b2c3d4-e5f6-4789-a012-3456789abcde",
            "paymentLinkId": "e2b3f5d5-0c62-47ba-8a01-6c1c209e0f77",
            "status": "ACTIVE"
        }
    ]
}'

Response Example 200

{
    "statusCode": 200,
    "messages": "success"
}

Endpoint:

Production

https://api.mayar.id/hl/v2/reviews/bulk-status/update

https://api.mayar.club/hl/v2/reviews/bulk-status/update

Authorization

Authorization · string · required

Example:

Authorization | Bearer Paste-Your-API-Key-Here

Request Body

input · array of object · required

List of reviews to update. Between 1 and 50 entries.

input.id · string · required

ID of the review to update. 3–100 characters.

input.status · string · required

New status for the review. One of ACTIVE, ARCHIVED, or INACTIVE.

input.paymentLinkId · string

ID of the payment link / product the review belongs to. 3–100 characters.

Response

Successful Response

Main Structure (Root)

statusCode · integer

Status code returned by the API.

messages · string

Status message that describes the status code. "success" on success, "failed" when the request body fails validation. A successful response contains no data key.

Errors

200 Validation Failed · object

Returned with messages set to "failed" and data holding the validation detail when the request body is invalid.

400 Bad Request · object

Returned with messages set to "Review is not valid! Please check your payload." when any referenced review does not belong to the authenticated merchant.

500 Server Error · object

Returned with messages set to the error description when the reviews cannot be updated.