Update Survey Response
Updates a specified survey response. One or more question answers or the response status may be changed in a single call.
Endpoint
POST
v5/survey/{survey_id}/surveyresponse/{response_id}
Requires authentication
Path Parameters
Identifies the survey and the specific response to update.
survey_id
string
required
The ID of the survey the response belongs to.
response_id
string
required
The ID of the survey response to update.
Query Parameters
status
string
The status to set on the response. Accepted values:
Complete, Partial, Disqualified.data
object
required
Keyed object of question answers to update. Each key is either the question's numeric ID or its shortname — both are interchangeable. At least one data parameter is required.
child attributes
value
string
Updates an open-text question. Example:
data[1][value]=Response text or data[Shortname][value]=Response text.
option SKU
string
Updates a select-type question using the option's SKU. The value should be the option title or reporting value. Example:
data[1][10001]=Yes or data[Shortname][10001]=Yes. When the reporting value for a checkbox question contains a comma, it must be URL-encoded.
option SKU-other
string
Updates the “Other” text field for a select question. Example:
data[1][10005-other]=Response text.
comment
string
Updates the comment field for a question. Example:
data[1][comment]=Response text.
supported question types
Response
Returns the updated response object.
result_ok
boolean
Whether the request succeeded.
data
object
The updated survey response object. See Get Survey Response for the full list of response fields.
child attributes
id
string
The unique ID of the response.
status
string
The response status after the update.
date_updated
string
Timestamp of when the response was last updated.
survey_data
object
Keyed object of question response data reflecting the updated values. Each key is a question ID.
child attributes
id
integer
The question ID.
type
string
The question type (e.g.
TEXTBOX, ESSAY, HIDDEN).question
string
The question title or label.
section_id
integer
The page/section ID the question belongs to.
answer
string | null
The respondent's answer after the update. Returns
null if not answered.shown
boolean
Whether the question was shown to the respondent.
Examples
Request (cURL)
curl -X POST "https://api.alchemer.com/v5/survey/1234567/surveyresponse/94?api_token=YOUR_API_TOKEN&api_token_secret=YOUR_API_TOKEN_SECRET&data[2][value]=John"
Response
{
"result_ok": true,
"data": {
"id": "94",
"contact_id": "",
"status": "Complete",
"is_test_data": "0",
"date_submitted": "2026-03-25 16:53:09 EDT",
"date_updated": "2026-03-25 18:15:34",
"date_started": "2026-03-25 16:53:09 EDT",
"session_id": "1774471989_69c44b350d8135.54354437",
"language": "English",
"link_id": null,
"url_variables": [],
"ip_address": "204.132.224.66",
"referer": null,
"user_agent": "SurveyGizmo REST API",
"response_time": null,
"data_quality": [],
"longitude": "-105.01560211182",
"latitude": "39.907299041748",
"country": "United States",
"city": "Denver",
"region": "CO",
"postal": "80234",
"dma": "751",
"survey_data": {
"2": {
"id": 2,
"type": "TEXTBOX",
"question": "First Name",
"section_id": 1,
"answer": "John",
"shown": true
},
"3": {
"id": 3,
"type": "TEXTBOX",
"question": "Last Name",
"section_id": 1,
"answer": null,
"shown": false
},
"4": {
"id": 4,
"type": "TEXTBOX",
"question": "Department",
"section_id": 1,
"answer": null,
"shown": false
}
}
}
}