WORKING
Moderation
get
/v1/moderation/flagsList moderation flags. listing-service's synchronous scanner already blocks a flagged write at the moment of sync — a flagged listing never reaches Postgres. These rows are a record of rejected attempts, useful for tuning the pattern list and handling merchant appeals.
Parameters
| status | query | optional |
| merchantId | query | optional |
| limit | query | optional |
Response (200)
get
/v1/moderation/flags/{id}Get a moderation flag
Parameters
| id | path | required |
Response (200)
| Field | Type | Required |
|---|---|---|
| id | string (uuid) | — |
| merchantId | string (uuid) | — |
| sellerId | string,null (uuid) | — |
| listingId | string,null (uuid) | — |
| fieldName | string | — |
| matchedPattern | string | — |
| rawExcerpt | string | — |
| status | FLAGGED | OVERRIDDEN | UPHELD | — |
| reviewedBy | stringnull | — |
| reviewedAt | string,null (date-time) | — |
| createdAt | string (date-time) | — |
post
/v1/moderation/flags/{id}/reviewOps review of a FLAGGED entry. Reviewing does not retroactively publish a listing — a confirmed false positive still requires the merchant to resubmit through Listings.
Parameters
| id | path | required |
| optional |
Request body
| Field | Type | Required |
|---|---|---|
| reviewedBy | string (uuid) | yes |
| decision | OVERRIDDEN | UPHELD | yes |
Response (201)
| Field | Type | Required |
|---|---|---|
| id | string (uuid) | — |
| merchantId | string (uuid) | — |
| sellerId | string,null (uuid) | — |
| listingId | string,null (uuid) | — |
| fieldName | string | — |
| matchedPattern | string | — |
| rawExcerpt | string | — |
| status | FLAGGED | OVERRIDDEN | UPHELD | — |
| reviewedBy | stringnull | — |
| reviewedAt | string,null (date-time) | — |
| createdAt | string (date-time) | — |