Post or edit a review

PUT /v1/reviews/meFreeWrites

Posts the human's public review of Geocode AI (1–5 stars, what they like and dislike, what they use it for), or replaces their existing one; each account has one review and earlier versions are kept. Only call it with the human's own rating and words, never invented ones. Published at once unless it holds links or the account is under a day old (then pending). Free; needs a key; one edit an hour. The human gets a thank-you email.

MCP tool submit_review · CLI geocode submit-review · RPC POST /v1/ops/submit_review

Input

Field	Type	Description
`rating` body, required	integer	Stars, 1 to 5.
`title` body	string	A headline. Default `""`.
`body` body	string	The review. Default `""`.
`likes` body	string	What works well. Default `""`.
`dislikes` body	string	What should be better. Default `""`.
`use_case` body	string	What they use it for. Default `""`.
`display_name` body	string	Name shown with the review (default: first name).
`display_company` body	string	Company shown with it, if they want.
`marketing_consent` body	boolean \| "true" \| "false"	May we quote it on our site and in marketing?

Example request

curl -X POST "https://geocodeai.dev/v1/reviews/me" \  -H "Authorization: Bearer $GEOCODE_API_KEY"

Example response

See the description above for what this returns.

Errors

Failures are RFC 9457 problems. Common ones here: 400 invalid_input, 401 unauthorized, 429 rate_limited.