Retrieving a Story from a Specific Release

To retrieve a version of a story from a specific release, use the from_release query parameter. Find this parameter in either of the following two places:

• The URL of the story in the Visual Editor when viewing a story from a release. The URL is in this format: /me/spaces/SPACE_ID/stories/BRANCH_ID/RELEASE_ID/index/STORY_ID
• The _storyblok_release query parameter in the preview URL when opening a preview environment in the Visual Editor.

The following example demonstrates how to retrieve the edited version of a single story from release 230891299745176 by appending from_release=230891299745176 to the request.

cURL

curl "https://api.storyblok.com/v2/cdn/stories/home\
?version=draft\
&token=ask9soUkv02QqbZgmZdeDAtt\
&from_release=230891299745176"

JS

// storyblok-js-client@>=7, node@>=18
import Storyblok from "storyblok-js-client";

const storyblok = new Storyblok({
  accessToken: "ask9soUkv02QqbZgmZdeDAtt",
});

try {
  const response = await storyblok.get('cdn/stories/home', {
    "version": "draft",
    "from_release": "230891299745176"
  })
  console.log({ response })
} catch (error) {
  console.log(error)
}

PHP

$client = new \Storyblok\Client('YOUR_STORYBLOK_SPACE_ACCESS_TOKEN');

$client->getStoryBySlug('home', [
  "version" => "draft",
  "from_release" => "230891299745176"
])->getBody();

Java

HttpResponse<String> response = Unirest.get("https://api.storyblok.com/v2/cdn/stories/home?version=draft&token=ask9soUkv02QqbZgmZdeDAtt&from_release=230891299745176")
  .asString();

C#

var client = new RestClient("https://api.storyblok.com/v2/cdn/stories/home?version=draft&token=ask9soUkv02QqbZgmZdeDAtt&from_release=230891299745176");
var request = new RestRequest(Method.GET);

IRestResponse response = client.Execute(request);

Python

import requests

url = "https://api.storyblok.com/v2/cdn/stories/home"

querystring = {"version":"draft","token":"ask9soUkv02QqbZgmZdeDAtt","from_release":"230891299745176"}

payload = ""
headers = {}

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

print(response.text)

Ruby

require 'storyblok'
client = Storyblok::Client.new(token: 'YOUR_TOKEN')

client.story('home', {:params => {
  "version" => "draft",
  "from_release" => "230891299745176"
}})

Swift

// .package(url: "https://github.com/storyblok/storyblok-swift.git", from: "1.1.0")
// Requires a `Block` content model — see https://www.storyblok.com/docs/quickstarts/apple-platforms/content-modeling
let client = StoryblokClient(
    library: Block.self,
    accessToken: "ask9soUkv02QqbZgmZdeDAtt",
    version: .draft,
    region: .eu
)

let story: Story<Block>? = try await client
    .story("home") { @Sendable query in
        query.fromRelease = "230891299745176"
    }
    .last()
    .values
    .first { @Sendable _ in true }

print(story!)

Kotlin

// implementation("com.storyblok:content-api-client:0.7.1")
val client = StoryblokClient(
    accessToken = "ask9soUkv02QqbZgmZdeDAtt",
    version = Draft,
)

val story = client
    .story("home") {
        fromRelease = "230891299745176"
    }
    .last()

println(story)

Response

{
  "story": {
    "name": "Home",
    "created_at": "2018-04-24T11:57:29.231Z",
    "published_at": "2026-10-12T09:47:00.856Z",
    "updated_at": "2026-10-12T09:47:00.865Z",
    "id": 107347,
    "uuid": "273bba42-834b-4a87-b190-eafe3eabb4d4",
    "content": {
      "_uid": "5c524540-192a-4110-ab1d-b8721f278811",
      "body": [
        {
          "_uid": "58acbf26-93f9-4faf-8f92-962eeb006029",
          "headline": "Hello World!",
          "component": "teaser",
          "_editable": "<!--#storyblok#{\"name\": \"teaser\", \"space\": \"44203\", \"uid\": \"58acbf26-93f9-4faf-8f92-962eeb006029\", \"id\": \"107347\"}-->"
        },
        {
          "_uid": "95ed695c-007a-438a-a9ff-5890138c1b60",
          "posts": [
            "bfea4895-8a19-4e82-ae1c-1c591dce3094"
          ],
          "component": "featured_posts",
          "_editable": "<!--#storyblok#{\"name\": \"featured_posts\", \"space\": \"44203\", \"uid\": \"95ed695c-007a-438a-a9ff-5890138c1b60\", \"id\": \"107347\"}-->"
        },
        {
          "_uid": "f3530c4a-abe0-4416-9488-e5f79445c9fb",
          "columns": [
            {
              "_uid": "2e738815-9e15-41c9-a7df-330d5157cc1f",
              "name": "Feature 1",
              "component": "feature",
              "_editable": "<!--#storyblok#{\"name\": \"feature\", \"space\": \"44203\", \"uid\": \"2e738815-9e15-41c9-a7df-330d5157cc1f\", \"id\": \"107347\"}-->"
            },
            {
              "_uid": "02ddfbcc-6f6a-4be8-a901-153a622e6e83",
              "name": "Feature 2",
              "component": "feature",
              "_editable": "<!--#storyblok#{\"name\": \"feature\", \"space\": \"44203\", \"uid\": \"02ddfbcc-6f6a-4be8-a901-153a622e6e83\", \"id\": \"107347\"}-->"
            },
            {
              "_uid": "802a531e-70ae-4ac0-8f34-fdba3b008031",
              "name": "Feature 3",
              "component": "feature",
              "_editable": "<!--#storyblok#{\"name\": \"feature\", \"space\": \"44203\", \"uid\": \"802a531e-70ae-4ac0-8f34-fdba3b008031\", \"id\": \"107347\"}-->"
            }
          ],
          "component": "grid",
          "_editable": "<!--#storyblok#{\"name\": \"grid\", \"space\": \"44203\", \"uid\": \"f3530c4a-abe0-4416-9488-e5f79445c9fb\", \"id\": \"107347\"}-->"
        }
      ],
      "component": "page",
      "_editable": "<!--#storyblok#{\"name\": \"page\", \"space\": \"44203\", \"uid\": \"5c524540-192a-4110-ab1d-b8721f278811\", \"id\": \"107347\"}-->"
    },
    "slug": "home",
    "full_slug": "home",
    "sort_by_date": null,
    "position": 40,
    "tag_list": [],
    "is_startpage": false,
    "parent_id": 0,
    "meta_data": null,
    "group_id": "d080c075-3a6b-4e29-b0dc-e6500714203e",
    "first_published_at": "2019-03-09T14:11:05.000Z",
    "release_id": "230891299745176",
    "lang": "default",
    "path": null,
    "alternates": [],
    "default_full_slug": null,
    "translated_slugs": null
  },
  "cv": 1792059567,
  "rels": [],
  "links": []
}