BUbuttondown
Survey Responses

Update Survey Response

Changed on

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

patch/survey_responses/{id}

Request

  • Base URL
    https://api.buttondown.com/v1
  • URL
    https://api.buttondown.com/v1/survey_responses/{id}
  • Auth
    API key in header Authorization

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"
  }
}

Changes

  • 594190e20eb7Revision changes
    • warning

      added the new comment_text_contains_link enum value to the //// response property for the response status

  • 9d2fc1dfd458Revision changes
    • warning

      added the new stripe.charge.succeeded enum value to the // response property for the response status