Surveys
Restore a version into the draft
POST
/surveys/{id}/versions/{versionId}/restoreNeedscontent.editReplaces the working draft with this version's content. Nothing goes live until you publish.
Authorization
secretKeyheader
AuthorizationBearer <sk_…>A secret API key from Settings → API keys. It acts with its creator's role.
Path Parameters
id*integerThe survey's id.
Range
1 <= valueversionId*integerThe version's id (from the versions list).
Range
1 <= valueResponse Body
OK
application/json- response
survey*A survey with its working draft. What visitors see is the version in publication.
restoredFrom*Shell
curl -X POST 'https://app.cueston.com/api/surveys/1/versions/1/restore'Example Response
JSON
{
"survey": {
"id": 42,
"name": "Onboarding tour",
"urlPattern": "https://app.acme.com/*",
"isActive": true,
"display": "slideout",
"position": "bottom-right",
"questions": [
{
"id": "string",
"type": "nps",
"prompt": "string",
"required": false,
"options": [
"string"
],
"scaleLabels": {
"low": "string",
"high": "string"
},
"placeholder": "string",
"followUp": {
"whenScoreBelow": -9007199254740991,
"questionId": "string"
}
}
],
"thankYou": "string",
"localizations": {
"property1": {
"thankYou": "string",
"questions": {
"property1": {
"prompt": "string",
"options": [
"string"
],
"scaleLabels": {
"low": "string",
"high": "string"
},
"placeholder": "string"
},
"property2": {
"prompt": "string",
"options": [
"string"
],
"scaleLabels": {
"low": "string",
"high": "string"
},
"placeholder": "string"
}
}
},
"property2": {
"thankYou": "string",
"questions": {
"property1": {
"prompt": "string",
"options": [
"string"
],
"scaleLabels": {
"low": "string",
"high": "string"
},
"placeholder": "string"
},
"property2": {
"prompt": "string",
"options": [
"string"
],
"scaleLabels": {
"low": "string",
"high": "string"
},
"placeholder": "string"
}
}
}
},
"styling": {
"accentColor": "string",
"backgroundColor": "string",
"textColor": "string",
"borderRadius": 0
},
"delayMs": 0,
"frequencyType": "once",
"frequencyDays": 1,
"audienceRules": {
"enabled": false,
"matchType": "all",
"rules": [
{
"id": "string",
"attribute": "string",
"operator": "equals",
"value": "string",
"key": "string"
}
]
},
"priority": 0,
"createdAt": "2026-10-26T09:30:00Z",
"updatedAt": "2026-10-26T09:30:00Z",
"publication": {
"production": {
"versionId": 7,
"version": 3,
"publishedAt": "2026-10-26T09:30:00Z"
},
"staging": {
"versionId": 7,
"version": 3,
"publishedAt": "2026-10-26T09:30:00Z"
}
},
"hasUnpublishedChanges": true
},
"restoredFrom": {
"id": 42,
"version": 3
}
}