Listings APIListings API
Get API keySign in
POST/api/v4/locations/reviews/respond/edit

Edit a response to an interaction

Edits a previously posted owner response on a review or interaction.

Requires an API key. See Authentication for header format and key rotation.

Parameters

Body

NameTypeRequiredDescription
responseIdstringrequiredID of the response to edit (the `id` from an interaction's `responses` array).
reviewIdstringrequiredID of the interaction the response belongs to.
responseContentstringrequiredUpdated text content of the response.
templateIdstringoptionalResponse-template ID to re-attribute the edited reply to, if any.

Sample request

Ready-to-paste body. Replace placeholder IDs and values with yours.

{
  "reviewId": "9e26d2a8-a6ed-42ea-8454-47d1c92ea841",
  "responseId": "2090753a-ece6-4837-8336-8494ad308523",
  "responseContent": "Thank you again — we've updated our reply to include our new store hours."
}

Responses

200Edit accepted and queued for re-submission. `data.editReviewResponse` echoes the identifiers.
{
  "data": {
    "editReviewResponse": {
      "status": "true",
      "reviewId": "9e26d2a8-a6ed-42ea-8454-47d1c92ea841",
      "responseId": "2090753a-ece6-4837-8336-8494ad308523"
    }
  }
}
401Unauthenticated — missing or invalid API key.

Updates the content of an existing owner response. The edited response is re-submitted to the source platform asynchronously — its interactionStatus returns to CREATED and transitions to COMPLETED or CONFIRMED once the platform confirms the update (see the response status flow).

Both reviewId (the interaction) and responseId (the specific reply) are required. Obtain the responseId from an interaction's responses[].id via Get interactions by IDs or List interactions.

Use case: fixing a typo in a live reply

When a published owner reply has a mistake, edit it in place rather than archiving and re-posting — this preserves the reply on platforms (like Google) that allow only one response per review. Look up the interaction's responses array, take the id of the reply to fix, and POST:

{
  "reviewId": "9e26d2a8-a6ed-42ea-8454-47d1c92ea841",
  "responseId": "2090753a-ece6-4837-8336-8494ad308523",
  "responseContent": "Thank you again — we've updated our reply to include our new store hours."
}

A status of "true" means the edit was accepted; poll Get interactions by IDs to confirm the updated reply reaches CONFIRMED on the source site.

curl -X POST 'https://listingsapi.com/api/v4/locations/reviews/respond/edit' \
  -H "Authorization: API $LISTINGSAPI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "responseId": "<responseId>",
    "reviewId": "<reviewId>",
    "responseContent": "<responseContent>",
    "templateId": "<templateId>"
  }'
Run in playground