Docs
Dashboard
On this page

    Review settings

    2 endpoints. Each needs an API key or OAuth token with the scope shown; the key already names its store, so paths start at /v1/store. Generated from the live contract; also in openapi.json.

    Review requests and moderation rules

    GET/v1/store/review-settings

    Or name the store: GET /v1/stores/{storeId}/review-settings

    customers:readgetReviewSettings

    Response ReviewSettings

    • autoRequestbooleanrequired
    • requestDelayDaysintegerrequired
    • moderationReviewModerationrequired
    • autoPublishMinRatingintegerrequired
    • rewardReviewRewardrequired

    Example

    curl "https://api.shopfa.st/v1/store/review-settings" \
      -H "Authorization: Bearer $SHOPFAST_API_KEY"
    const res = await fetch('https://api.shopfa.st/v1/store/review-settings', {
      method: 'GET',
      headers: {
        Authorization: `Bearer ${process.env.SHOPFAST_API_KEY}`,
      },
    });
    if (!res.ok) throw new Error((await res.json()).detail);
    const data = await res.json();
    import os, requests
    
    res = requests.request(
        "GET",
        "https://api.shopfa.st/v1/store/review-settings",
        headers={"Authorization": f"Bearer {os.environ['SHOPFAST_API_KEY']}"},
    )
    res.raise_for_status()
    data = res.json()
    req, _ := http.NewRequest("GET", "https://api.shopfa.st/v1/store/review-settings", nil)
    req.Header.Set("Authorization", "Bearer "+os.Getenv("SHOPFAST_API_KEY"))
    res, err := http.DefaultClient.Do(req)
    Try it with your key

    Use a test key on a development store. The key stays in this tab (sessionStorage) and is sent only to the base URL above.

    Update review requests and moderation rules

    PUT/v1/store/review-settings

    Or name the store: PUT /v1/stores/{storeId}/review-settings

    customers:writeupdateReviewSettings

    Body

    • autoRequestboolean
    • requestDelayDaysinteger
    • moderation"auto_publish" | "manual"
    • autoPublishMinRatinginteger
    • rewardobject
      • enabledboolean
      • type"percent" | "fixed"
      • valueinteger
      • minRatinginteger
      • expiryDaysinteger | null

    Response ReviewSettings

    • autoRequestbooleanrequired
    • requestDelayDaysintegerrequired
    • moderationReviewModerationrequired
    • autoPublishMinRatingintegerrequired
    • rewardReviewRewardrequired

    Example

    curl -X PUT "https://api.shopfa.st/v1/store/review-settings" \
      -H "Authorization: Bearer $SHOPFAST_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
      "autoRequest": true,
      "requestDelayDays": 3,
      "moderation": "auto_publish",
      "autoPublishMinRating": 4,
      "reward": {}
    }'
    const res = await fetch('https://api.shopfa.st/v1/store/review-settings', {
      method: 'PUT',
      headers: {
        Authorization: `Bearer ${process.env.SHOPFAST_API_KEY}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        "autoRequest": true,
        "requestDelayDays": 3,
        "moderation": "auto_publish",
        "autoPublishMinRating": 4,
        "reward": {}
      }),
    });
    if (!res.ok) throw new Error((await res.json()).detail);
    const data = await res.json();
    import os, requests
    
    res = requests.request(
        "PUT",
        "https://api.shopfa.st/v1/store/review-settings",
        headers={"Authorization": f"Bearer {os.environ['SHOPFAST_API_KEY']}"},
        json={
          "autoRequest": True,
          "requestDelayDays": 3,
          "moderation": "auto_publish",
          "autoPublishMinRating": 4,
          "reward": {}
        },
    )
    res.raise_for_status()
    data = res.json()
    req, _ := http.NewRequest("PUT", "https://api.shopfa.st/v1/store/review-settings", strings.NewReader(`{
      "autoRequest": true,
      "requestDelayDays": 3,
      "moderation": "auto_publish",
      "autoPublishMinRating": 4,
      "reward": {}
    }`))
    req.Header.Set("Authorization", "Bearer "+os.Getenv("SHOPFAST_API_KEY"))
    req.Header.Set("Content-Type", "application/json")
    res, err := http.DefaultClient.Do(req)
    Try it with your key

    Use a test key on a development store. The key stays in this tab (sessionStorage) and is sent only to the base URL above.

    Was this page helpful?