reputation30 ops

Reputation API

Reviews, ratings, feedback criteria, and reputation scores.

Queries

QUERY

adminListReviews

#

List reviews with admin filters. # Authorization Requires TenantAdmin or PlatformAdmin role. # Filters - targetId: Reviews written about this account, shop or lot - targetRole / targetType: Who is reviewed - app: The vertical the review belongs to - orderId: Reviews left on one order - moderationStatuses: Any of these statuses - minStars / maxStars: Rating range, in stars - fromDate / toDate: Date range filter Newest first.

Arguments

  • input!

    Default

    {
      "targetId": null,
      "targetRole": null,
      "targetType": null,
      "app": null,
      "orderId": null,
      "moderationStatuses": null,
      "minStars": null,
      "maxStars": null,
      "fromDate": null,
      "toDate": null,
      "pagination": {
        "limit": 10,
        "page": 1,
        "after": null
      }
    }
Returns!
QUERY

adminModerationPolicies

#

The review moderation policy of every vertical and review target, or of one vertical when app is given. Always returns one entry per valid pair; a pair nothing has been saved for comes back with the defaults and isConfigured: false. Only accessible by tenant admins: the blocklist is not for the people it is meant to catch.

Arguments

  • app
Returns[!]!
QUERY

adminReview

#

One review, whatever its moderation status, for a moderator to read in full before deciding on it. Null when the workspace has no such review. # Authorization Requires TenantAdmin or PlatformAdmin role.

Arguments

  • reviewIdID!
Returns
QUERY

averageRatingStats

#

Get average rating statistics for a target. Returns average score, total reviews, and rating distribution (1-5 stars). Ratings of a customer are returned only to staff and to that customer.

Arguments

  • targetType!
  • targetIdString!
Returns!
QUERY

entityReviews

#

List reviews for a specific target entity. Returns published reviews (auto-approved or manually approved) for the given target type and ID: reviews with written text first, newest first within each group. A bare rating still counts in the target's average; the score itself never changes a review's place. A shop, a parking lot, a service provider and a product are public. Reviews of a driver or of a customer are returned only to staff and to the person they are about; anyone else gets PERMISSION_DENIED.

Arguments

  • targetType!
  • targetIdString!
  • paging!

    Default

    {
      "limit": 10,
      "page": 1,
      "after": null
    }
Returns!
QUERY

getCriteriaSet

#

Get a criteria set by ID with all its criteria items. # Authorization Requires TenantAdmin or PlatformAdmin role. Returns the caller's own sets and the global defaults; another tenant's set is reported as not found.

Arguments

  • id!
Returns!
QUERY

getReviewCriteria

#

Get THE criteria set for the current app/role/target (automatically determined from context)

Arguments

  • targetType!
Returns!
QUERY

listCriteriaSets

#

List all criteria sets for the tenant (admin view). Supports filtering by app and target type, with pagination. Unlike the client-facing query, this includes inactive sets when includeInactive is true. # Authorization Requires TenantAdmin or PlatformAdmin role.

Arguments

  • input!
Returns!
QUERY

myAverageRatingStats

#

Get average rating statistics for the current user. Target type is automatically determined from the user's role.

Returns!
QUERY

myBoolCriteriaSummary

#

Get summary of Bool criteria (chips) selections for the current user. Target type is automatically determined from the user's role.

Returns!
QUERY

myHighlightedReviews

#

Get random high-rated review comments for the current user. Target type is automatically determined from the user's role.

Arguments

  • minRatingInt!

    Minimum star rating

    Default

    5
  • limitInt!

    Maximum number of reviews to return

    Default

    5
Returns[!]!
QUERY

myReceivedReviews

#

Published reviews written about the signed-in merchant or service provider, newest first. myReviews is the other direction: reviews the caller wrote. A vendor never writes any, which is why a vendor screen built on it stayed empty.

Arguments

  • paging!

    Default

    {
      "limit": 10,
      "page": 1,
      "after": null
    }
Returns!
QUERY

myReviews

#

List reviews written by the currently authenticated user, scoped to the calling client's app and role. The app (x-app) and role (x-role) come from the request context, so the same account sees a different set of reviews per app: a shop customer sees only the reviews it left as a shop customer, not ones it left as a taxi passenger or a shop vendor. This mirrors how create_review stamps each review with (app, reviewer_role).

Arguments

  • paging!

    Default

    {
      "limit": 10,
      "page": 1,
      "after": null
    }
Returns!
QUERY

serviceRatingStats

#

Average rating and 1-5 star distribution over the reviews serviceReviews lists.

Arguments

  • serviceId!
Returns!
QUERY

serviceReviews

#

Published reviews of the jobs done for a service: reviews with written text first, newest first within each group. A bare rating still counts in serviceRatingStats; the score itself never changes a review's place. Each review is of one provider, but who is withheld: targetId, targetAccount and orderId are null. A customer browsing a service learns who the providers are only once they bid.

Arguments

  • serviceId!
  • paging!

    Default

    {
      "limit": 10,
      "page": 1,
      "after": null
    }
Returns!

Mutations

MUTATION

adminSetModerationPolicy

#

Change the review moderation policy of one vertical and review target, creating it on first save. Only the fields given are changed. Applies to reviews submitted from now on; reviews already published or waiting are not re-evaluated. Only accessible by tenant admins.

Arguments

  • input!
Returns!
MUTATION

approveReview

#

Publish a review: one that is awaiting approval, or one that was rejected or taken down and is being restored. Only accessible by tenant admins. The review becomes visible, its moderation status is set to Approved, and the reviewed party's rating counts it. Fails with INVALID_MODERATION_TRANSITION when the review is already published, and REVIEW_MODERATION_CONFLICT when someone else moderated it first.

Arguments

  • input!
Returns!
MUTATION

approveReviews

#

Approve several reviews at once: the same decision as approveReview applied to each, at most 100. One review failing does not stop the rest; failed says which did not change and why. Only accessible by tenant admins.

Arguments

  • input!
Returns!
MUTATION

createCriteria

#

Create a new criteria within a set. # Authorization Requires TenantAdmin or PlatformAdmin role, and writes are limited to the caller's own sets: a tenant admin edits only its tenant's sets, and the global defaults belong to a platform session with no tenant. Any other set is reported as not found.

Arguments

  • input!
Returns!
MUTATION

createCriteriaSet

#

Create a new criteria set. # Authorization Requires TenantAdmin or PlatformAdmin role.

Arguments

  • input!
Returns!
MUTATION

createReview

#

Create a new review/rating for an order. The caller must have taken part in the order. The review is filed under the order's vertical and the target participant is resolved from the order; when the order has several of targetType (two shops), targetId says which, and omitting it fails with AMBIGUOUS_REVIEW_TARGET.

Arguments

  • input!
Returns!
MUTATION

deleteCriteria

#

Delete a criteria (soft delete). # Authorization Requires TenantAdmin or PlatformAdmin role, and writes are limited to the caller's own sets: a tenant admin edits only its tenant's sets, and the global defaults belong to a platform session with no tenant. Any other set is reported as not found.

Arguments

  • id!
ReturnsBoolean!
MUTATION

deleteCriteriaSet

#

Delete a criteria set (soft delete). # Authorization Requires TenantAdmin or PlatformAdmin role, and writes are limited to the caller's own sets: a tenant admin edits only its tenant's sets, and the global defaults belong to a platform session with no tenant. Any other set is reported as not found.

Arguments

  • id!
ReturnsBoolean!
MUTATION

regenerateReviewAiModeration

#

Regenerate the AI moderation suggestion for one review. Admin-only. Requires the tenant to have review_moderation_enabled turned on under Settings → AI Features and at least one configured AI provider with a remaining monthly budget.

Arguments

  • reviewIdString!
Returns!
MUTATION

rejectReview

#

Hide a review: reject one that is awaiting approval, or take down one that is already published. Only accessible by tenant admins. The review is hidden, its moderation status is set to Rejected with the reason stored, and the reviewed party's rating stops counting it. approveReview restores it. Fails with INVALID_MODERATION_TRANSITION when the review is already rejected, and REVIEW_MODERATION_CONFLICT when someone else moderated it first.

Arguments

  • input!
Returns!
MUTATION

rejectReviews

#

Reject or take down several reviews at once with one reason: the same decision as rejectReview applied to each, at most 100. One review failing does not stop the rest; failed says which did not change and why. Only accessible by tenant admins.

Arguments

  • input!
Returns!
MUTATION

reorderCriteria

#

Reorder criteria within a set. The order of IDs in the input determines the new positions. # Authorization Requires TenantAdmin or PlatformAdmin role, and writes are limited to the caller's own sets: a tenant admin edits only its tenant's sets, and the global defaults belong to a platform session with no tenant. Any other set is reported as not found.

Arguments

  • input!
Returns[!]!
MUTATION

respondToReview

#

Reply in public to a review about the caller: a merchant to a review of their shop, a provider to a review of their work or their lot. The review must be published. A second reply replaces the first. Fails with PERMISSION_DENIED when the review is about someone else.

Arguments

  • input!
Returns!
MUTATION

updateCriteria

#

Update an existing criteria. # Authorization Requires TenantAdmin or PlatformAdmin role, and writes are limited to the caller's own sets: a tenant admin edits only its tenant's sets, and the global defaults belong to a platform session with no tenant. Any other set is reported as not found.

Arguments

  • input!
Returns!
MUTATION

updateCriteriaSet

#

Update an existing criteria set. # Authorization Requires TenantAdmin or PlatformAdmin role, and writes are limited to the caller's own sets: a tenant admin edits only its tenant's sets, and the global defaults belong to a platform session with no tenant. Any other set is reported as not found.

Arguments

  • input!
Returns!