Restore a Story Version

This endpoint lets you restore a story to a specific version.

https://mapi.storyblok.com/v1/spaces/:space_id/stories/:story_id/restore_with

Path Parameters

:space_id
required number

The space ID

:story_id
required number

The numeric ID of the story

Query Parameters

versions_v2
required boolean

When set to true, the version passed is treated as a new story version, while setting it to false treats it as a legacy version.

Read the note on the get story versions endpoint to learn how to differentiate between new and legacy versions.
version
required string

The ID of the story version

Select a Language

Request

curl "https://mapi.storyblok.com/v1/spaces/325428/stories/623949938/restore_with?version=55648825&versions_v2=true" \
  -X GET \
  -H "Authorization: YOUR_OAUTH_TOKEN" \
  -H "Content-Type: application/json"

Request

// Using the Universal JavaScript Client:
// https://github.com/storyblok/storyblok-js-client
Storyblok.get('/spaces/325428/stories/623949938/restore_with', {
  "version": "55648825",
  "versions_v2": "true"
})
  .then(response => {
    console.log(response)
  }).catch(error => { 
    console.log(error)
  })

Request

$client = new \Storyblok\ManagementClient('YOUR_OAUTH_TOKEN');

$client->get('/spaces/325428/stories/623949938/restore_with', [
  "version" =>  "55648825",
  "versions_v2" =>  "true"
])->getBody();

Request

require 'storyblok'
client = Storyblok::Client.new(oauth_token: 'YOUR_OAUTH_TOKEN')

client.false('/spaces/325428/stories/623949938/restore_with', {:params => {
  "version" =>  "55648825",
  "versions_v2" =>  "true"
}})

Request

HttpResponse<String> response = Unirest.get("https://mapi.storyblok.com/v1/spaces/325428/stories/623949938/restore_with?version=55648825&versions_v2=true")
  .header("Authorization", "YOUR_OAUTH_TOKEN")
  .asString();

Request

var client = new RestClient("https://mapi.storyblok.com/v1/spaces/325428/stories/623949938/restore_with?version=55648825&versions_v2=true");
var request = new RestRequest(Method.GET);

request.AddHeader("Authorization", "YOUR_OAUTH_TOKEN");
IRestResponse response = client.Execute(request);

Request

import Foundation

let headers = [
  "Content-Type": "application/json",
  "Authorization": "YOUR_OAUTH_TOKEN"
]

let request = NSMutableURLRequest(url: NSURL(string: "https://mapi.storyblok.com/v1/spaces/325428/stories/623949938/restore_with?version=55648825&versions_v2=true")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0)
request.method = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()

Request

import requests

url = "https://mapi.storyblok.com/v1/spaces/325428/stories/623949938/restore_with"

querystring = {"version":"55648825","versions_v2":"true"}

payload = ""
headers = {
  'Content-Type': "application/json",
  'Authorization': "YOUR_OAUTH_TOKEN"
}

response = requests.request("GET", url, data=payload, headers=headers, params=querystring)

print(response.text)