reputation31 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 - targetAccountId: Filter reviews written ABOUT this account - targetRole: Filter by target's role (Driver, Merchant, Customer) - targetType: Filter by target type - app: Filter by app context - flaggedOnly: Show only flagged reviews - published: Filter by published status - minScore / maxScore: Score range filter - fromDate / toDate: Date range filter

Arguments

  • input!

    Default

    {
  "targetId": null,
  "targetRole": null,
  "targetType": null,
  "app": null,
  "moderationStatus": null,
  "minScore": null,
  "maxScore": null,
  "fromDate": null,
  "toDate": null,
  "pagination": {
    "limit": 10,
    "page": 1,
    "after": null
  }
}
Returns!
QUERY

averageRatingStats

#

Get average rating statistics for a target. Returns average score, total reviews, and rating distribution (1-5 stars).

Arguments

  • targetType!
  • targetIdString!
Returns!
QUERY

boolCriteriaSummary

#

Get summary of Bool criteria (chips) selections for a target. Returns positive and negative feedback categories with selection counts.

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.

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.

Arguments

  • id!
Returns!
QUERY

getReputationProfile

#

Get reputation profile for an account

Arguments

  • input!
Returns
QUERY

getReviewCriteria

#

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

Arguments

  • targetType!
Returns!
QUERY

highlightedReviews

#

Get random high-rated review comments for a target. Useful for displaying testimonials or highlighted feedback.

Arguments

  • targetType!
  • targetIdString!
  • minRatingInt!

    Minimum star rating

    Default

    5
  • limitInt!

    Maximum number of reviews to return

    Default

    5
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

moderationPolicies

#

List all moderation policies for the tenant.

Returns[!]!
QUERY

moderationPolicy

#

Get a moderation policy by app. Returns null if no policy exists for this app (defaults to no moderation).

Arguments

  • app!
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

myReviews

#

List reviews written by the currently authenticated user.

Arguments

  • paging!

    Default

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

targetReviewAiSummary

#

Fetch the persisted AI summary for one (target_type, target_id). Returns null when no summary has been generated yet — the admin is expected to call regenerateTargetReviewAiSummary to create the first row.

Arguments

  • targetType!
  • targetIdString!
Returns

Mutations

MUTATION

approveReview

#

Approve a pending review. Only accessible by tenant admins. The review will become visible and its moderation status will be set to Approved.

Arguments

  • input!
Returns!
MUTATION

createCriteria

#

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

Arguments

  • input!
Returns!
MUTATION

createCriteriaSet

#

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

Arguments

  • input!
Returns!
MUTATION

createModerationPolicy

#

Create a new moderation policy for a vertical. Only one policy per app is allowed.

Arguments

  • input!
Returns!
MUTATION

createReview

#

Create a new review/rating for an order. The target participant is resolved from the order automatically.

Arguments

  • input!
Returns!
MUTATION

deleteCriteria

#

Delete a criteria (soft delete). # Authorization Requires TenantAdmin or PlatformAdmin role.

Arguments

  • id!
ReturnsBoolean!
MUTATION

deleteCriteriaSet

#

Delete a criteria set (soft delete). # Authorization Requires TenantAdmin or PlatformAdmin role.

Arguments

  • id!
ReturnsBoolean!
MUTATION

deleteModerationPolicy

#

Delete a moderation policy. Returns true if the policy was deleted, false if it didn't exist.

Arguments

  • app!
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

regenerateTargetReviewAiSummary

#

Regenerate the AI summary for one review target ((target_type, target_id)). 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

  • targetType!
  • targetIdString!
Returns!
MUTATION

rejectReview

#

Reject a pending review. Only accessible by tenant admins. The review will be hidden and its moderation status will be set to Rejected with the provided reason stored.

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.

Arguments

  • input!
Returns[!]!
MUTATION

updateCriteria

#

Update an existing criteria. # Authorization Requires TenantAdmin or PlatformAdmin role.

Arguments

  • input!
Returns!
MUTATION

updateCriteriaSet

#

Update an existing criteria set. # Authorization Requires TenantAdmin or PlatformAdmin role.

Arguments

  • input!
Returns!
MUTATION

updateModerationPolicy

#

Update an existing moderation policy.

Arguments

  • input!
Returns!

Build the foundation once. Expand without limits.

BetterSuite is built for teams who see on-demand as a business — not a feature.

Start Free TrialView Pricing