Skip to content

Restore draft from backup

POST
/surveys/{id}/draft/backups/{backupId}/restore
curl --request POST \
--url https://app.surveyrock.com/api/v1/surveys/example/draft/backups/example/restore \
--header 'Authorization: Bearer <token>'

Restores the draft state from a previous backup. This is useful for undoing a version restore operation.

id
required
string

Survey ID

backupId
required
string

Backup ID to restore from

Draft restored from backup successfully

Media typeapplication/json
object
success
boolean
data
object
restoredFromBackupId
string
message
string
meta

Standard response metadata

object
timestamp

Response timestamp in ISO 8601 format

string format: date-time
version

API version

string
requestId

Unique request identifier

string
Example
{
"success": true,
"meta": {
"version": "3.0"
}
}

Survey or backup not found

Media typeapplication/json

Standard error response format

object
success
boolean
error
object
code

Stable, snake_case domain code – see ApiErrorHandler::EXCEPTION_MAP and DomainException

string
message

Human-readable error message

string
suggestion

Imperative recovery hint for this domain code – see ApiErrorHandler::DOMAIN_CODE_SUGGESTIONS

string
retryable

Whether retrying the identical request might succeed without any change on the caller’s end

boolean
details

Additional, code-specific error details

object
meta

Standard response metadata

object
timestamp

Response timestamp in ISO 8601 format

string format: date-time
version

API version

string
requestId

Unique request identifier

string
Example
{
"success": false,
"error": {
"code": "survey_not_found"
},
"meta": {
"version": "3.0"
}
}