Docs

Add to your Fix Log

Preview· P9
POST
/review-fixes

Adds a fix: what you changed, the day it was fixed, and up to three things reviews mention that it answers (chips or insight topics). It's checked before it shows; one that names a person or gives contact details waits for a moderator. It can be added to but never rewritten after seven days, and it never moves your score or your place in any order. Three a week at most. review_fix.published fires when it shows. A test key checks it and writes nothing.

Scope: reviews:write · Plan: Growth, Pro and Enterprise in live mode (any Reviews level for an Agoo Reviews key); every plan in test mode.

Authorization

headerAuthorizationBearer <token>

Send Authorization: Bearer <token> on every request. The token is one of:

PrefixWhat it isWhere it may be used
agoo_sk_live_Secret key, live modeYour servers only
agoo_sk_test_Secret key, test modeYour servers only
agoo_pk_live_Publishable key, live modeBrowsers and apps: create pre-registrations and bookings, read public booking types (with their intake questions) and their free slots, read the visit types open for pre-registration with their public forms. Never lists people.
agoo_pk_test_Publishable key, test modeAs above, in test mode
agoo_rk_live_Agoo Reviews key, live mode: a business on Agoo Reviews on its own, on Reviews BusinessYour servers only: the Reviews operations, for that business and the branches the key names
agoo_rk_test_Agoo Reviews key, test modeAs above, on any level: it reads the business's reviews and checks every write without saving it
agoo_ck_live_Check API key, live mode, for a Check API partnerYour servers only: the Checks operations (checks:read), billed per check
agoo_ck_test_Check API key, test modeAs above, answering only the published test values, never billed

Admins create keys in Console → Developers → API keys and choose each key's scopes; a business on Agoo Reviews on its own creates its keys in its business area on agoo.reviews, under Developers; a Check API partner creates its keys in its partner area on agoo.reviews. A key is shown once. Never put a secret key in a URL, a browser or a mobile app.

Scope: reviews:write

Request Body

application/json
  1. body
body*string

What you changed, in your own words. No phone numbers, emails, links or staff names.

Length10 <= length <= 280
fixed_on*string

The day it was fixed: not in the future, within the last 90 days.

Formatdate
chips?array<string>

Up to three of the not-so-good chips reviews of your category pick.

Itemsitems <= 3
topics?array<string>

Up to three insight topics.

Itemsitems <= 3
place_id?ReviewPlaceId

A branch's ID on Agoo Reviews (TypeID with the rplace prefix): one of your sites, as a page shows it.

Match^rplace_[0-7][0-9a-hjkmnp-tv-z]{25}$
Example"rplace_01m6a2b3c4d5e6f7g8h9jkmnpq"

Response Body

The fix, as it's kept.

application/json
  1. response

An entry in your page's Fix Log: what you changed, dated, and what it answers.

id*|

An rfix_ ID. Null only on a test key's answer, which writes nothing.

object*"review_fix"
Value in"review_fix"
business_id*string
Match^rbiz_[0-7][0-9a-hjkmnp-tv-z]{25}$
place_id*string|null
body*string
fixed_on*string
Formatdate
chips*array<string>
topics*array<string>
status*string

A new fix is checked before it shows; one that names a person or gives contact details waits for a moderator.

Value in"screening""published""held""removed"
still_count*integer

Reviewers who tapped Still a Problem.

since_mentions*integer

Reviews since the fix that mention what it answers.

edited*boolean
updates*array<>
created*string
Formatdate-time
test?boolean

True when a test key checked it and nothing was written.

curl -X POST 'https://api.agoohq.com/v1/review-fixes' \  -H 'Content-Type: application/json' \  -d '{  "body": "stringstri",  "fixed_on": "2019-08-24"}'
{  "id": "string",  "object": "review_fix",  "business_id": "string",  "place_id": "string",  "body": "string",  "fixed_on": "2019-08-24",  "chips": [    "string"  ],  "topics": [    "string"  ],  "status": "screening",  "still_count": 0,  "since_mentions": 0,  "edited": true,  "updates": [    {      "body": "string",      "created": "2019-08-24T14:15:22Z"    }  ],  "created": "2019-08-24T14:15:22Z",  "test": true}