reputation31 ops

API de Reputation

Reviews, ratings, feedback criteria, and reputation scores.

Consultas

CONSULTA

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

Argumentos

  • input!

    Por defecto

    {
  "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
  }
}
Devuelve!
CONSULTA

averageRatingStats

#

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

Argumentos

  • targetType!
  • targetIdString!
Devuelve!
CONSULTA

boolCriteriaSummary

#

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

Argumentos

  • targetType!
  • targetIdString!
Devuelve!
CONSULTA

entityReviews

#

List reviews for a specific target entity. Returns published reviews (auto-approved or manually approved) for the given target type and ID.

Argumentos

  • targetType!
  • targetIdString!
  • paging!

    Por defecto

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

getCriteriaSet

#

Get a criteria set by ID with all its criteria items. # Authorization Requires TenantAdmin or PlatformAdmin role.

Argumentos

  • id!
Devuelve!
CONSULTA

getReputationProfile

#

Get reputation profile for an account

Argumentos

  • input!
Devuelve
CONSULTA

getReviewCriteria

#

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

Argumentos

  • targetType!
Devuelve!
CONSULTA

highlightedReviews

#

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

Argumentos

  • targetType!
  • targetIdString!
  • minRatingInt!

    Minimum star rating

    Por defecto

    5
  • limitInt!

    Maximum number of reviews to return

    Por defecto

    5
Devuelve[!]!
CONSULTA

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.

Argumentos

  • input!
Devuelve!
CONSULTA

moderationPolicies

#

List all moderation policies for the tenant.

Devuelve[!]!
CONSULTA

moderationPolicy

#

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

Argumentos

  • app!
Devuelve
CONSULTA

myAverageRatingStats

#

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

Devuelve!
CONSULTA

myBoolCriteriaSummary

#

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

Devuelve!
CONSULTA

myHighlightedReviews

#

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

Argumentos

  • minRatingInt!

    Minimum star rating

    Por defecto

    5
  • limitInt!

    Maximum number of reviews to return

    Por defecto

    5
Devuelve[!]!
CONSULTA

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).

Argumentos

  • paging!

    Por defecto

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

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.

Argumentos

  • targetType!
  • targetIdString!
Devuelve

Mutaciones

MUTACIÓN

approveReview

#

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

Argumentos

  • input!
Devuelve!
MUTACIÓN

createCriteria

#

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

Argumentos

  • input!
Devuelve!
MUTACIÓN

createCriteriaSet

#

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

Argumentos

  • input!
Devuelve!
MUTACIÓN

createModerationPolicy

#

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

Argumentos

  • input!
Devuelve!
MUTACIÓN

createReview

#

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

Argumentos

  • input!
Devuelve!
MUTACIÓN

deleteCriteria

#

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

Argumentos

  • id!
DevuelveBoolean!
MUTACIÓN

deleteCriteriaSet

#

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

Argumentos

  • id!
DevuelveBoolean!
MUTACIÓN

deleteModerationPolicy

#

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

Argumentos

  • app!
DevuelveBoolean!
MUTACIÓN

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.

Argumentos

  • reviewIdString!
Devuelve!
MUTACIÓN

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.

Argumentos

  • targetType!
  • targetIdString!
Devuelve!
MUTACIÓN

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.

Argumentos

  • input!
Devuelve!
MUTACIÓN

reorderCriteria

#

Reorder criteria within a set. The order of IDs in the input determines the new positions. # Authorization Requires TenantAdmin or PlatformAdmin role.

Argumentos

  • input!
Devuelve[!]!
MUTACIÓN

updateCriteria

#

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

Argumentos

  • input!
Devuelve!
MUTACIÓN

updateCriteriaSet

#

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

Argumentos

  • input!
Devuelve!
MUTACIÓN

updateModerationPolicy

#

Update an existing moderation policy.

Argumentos

  • input!
Devuelve!