Sign in

3a702c095d22

latestOpenAPI 3.1.0MIT2026-08-08133230925.7 KB
Survey Responses

Update Survey Response

Update a survey response's text. Only the response owner (subscriber) can update their response.

patch/survey_responses/{id}

Path parameters

idstring required

Request body

textstring nullable

The text response to update. Only applicable if the survey has freeform responses enabled.

Response

OK

idstring required

A unique TypeID associated with the object.

creation_datestring date-time required

The date and time at which the object was first created.

answerstring required

The answer given to the survey.

textstring required

Optional text included by the subscriber with the response. Subscribers are only prompted to supply a text response if the is_freeform_response_enabled field is set to true on the survey.

survey_idstring required

The ID of the survey this response was submitted to.

subscriber_idstring required

The ID of the subscriber who submitted this response.

email_idstring nullable

The ID of the email where this response was submitted, if any.

automation_idstring nullable

The ID of the automation where this response was submitted, if any.

sourcestring nullable

For responses not tied to an email or automation, the origin the survey was answered from (e.g. a transactional:* template). Null otherwise.

Example response

{
  "subscriber": {
    "country": "US",
    "email_address": "telemachus@buttondown.email",
    "delivered_count": 12,
    "open_count": 7,
    "clicked_count": 3,
    "open_rate": 0.5833,
    "click_rate": 0.25
  },
  "email": {
    "slug": "welcome-to-the-newsletter"
  }
}