Cache Invalidation

Storyblok uses a Content Delivery Network (CDN) to deliver content as fast as possible. To have a high cache hit rate for published content, Storyblok uses a cv parameter (cache version), which is a Unix timestamp.

The most up-to-date cv value of a space can be retrieved with an API call excluding the cv parameter:

https://api.storyblok.com/v2/cdn/spaces/me/?token=YOUR_TOKEN

The API response will contain a cv value that can be used in subsequent API requests to receive the latest version of the content. In order to handle cache invalidation, the cv value needs to be stored in memory. Furthermore, it needs to be updated when certain criteria are met. For example, Storyblok’s webhook events may be used to invalidate the cache whenever content is published, updated, or deleted.

Tip

While many API endpoints return the cache version, it is recommended to use /v2/cdn/spaces/me/ for performance purposes (see Retrieve Current Space for further reference).

Related resources

How stories are cached in the Content Delivery API

Examples

Retrieve the latest cache version

cURL

curl "https://api.storyblok.com/v2/cdn/spaces/me\
?token=wANpEQEsMYGOwLxwXQ76Ggtt"

JS

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

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

try {
  const response = await storyblok.get('cdn/spaces/me', {})
  console.log({ response })
} catch (error) {
  console.log(error)
}

PHP

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

$client->get('spaces/me')->getBody();

Java

HttpResponse<String> response = Unirest.get("https://api.storyblok.com/v2/cdn/spaces/me?token=wANpEQEsMYGOwLxwXQ76Ggtt")
  .asString();

C#

var client = new RestClient("https://api.storyblok.com/v2/cdn/spaces/me?token=wANpEQEsMYGOwLxwXQ76Ggtt");
var request = new RestRequest(Method.GET);

IRestResponse response = client.Execute(request);

Python

import requests

url = "https://api.storyblok.com/v2/cdn/spaces/me"

querystring = {"token":"wANpEQEsMYGOwLxwXQ76Ggtt"}

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.space()

Swift

let storyblok = URLSession(storyblok: .cdn(accessToken: "wANpEQEsMYGOwLxwXQ76Ggtt"))
let request = URLRequest(storyblok: storyblok, path: "spaces/me")
let (data, _) = try await storyblok.data(for: request)
print(try JSONSerialization.jsonObject(with: data))

Kotlin

val client = HttpClient {
    install(Storyblok(CDN)) {
        accessToken = "wANpEQEsMYGOwLxwXQ76Ggtt"
    }
}

val response = client.get("spaces/me")

println(response.body<JsonElement>())

Example Response

{
  "space": {
    "domain": "https://storyblok.com/",
    "id": 123456,
    "name": "Example Space",
    "version": 1706094649
  }
}

Request a specific cache version

cURL

curl "https://api.storyblok.com/v2/cdn/stories\
?cv=1541863983\
&token=wANpEQEsMYGOwLxwXQ76Ggtt"

JS

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

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

try {
  const response = await storyblok.get('cdn/stories', {
  "cv": "1541863983"
})
  console.log({ response })
} catch (error) {
  console.log(error)
}

PHP

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

$client->getStories([
  "cv" => "1541863983"
])->getBody();

Java

HttpResponse<String> response = Unirest.get("https://api.storyblok.com/v2/cdn/stories?cv=1541863983&token=wANpEQEsMYGOwLxwXQ76Ggtt")
  .asString();

C#

var client = new RestClient("https://api.storyblok.com/v2/cdn/stories?cv=1541863983&token=wANpEQEsMYGOwLxwXQ76Ggtt");
var request = new RestRequest(Method.GET);

IRestResponse response = client.Execute(request);

Python

import requests

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

querystring = {"cv":"1541863983","token":"wANpEQEsMYGOwLxwXQ76Ggtt"}

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.stories({:params => {
  "cv" => "1541863983"
}})

Swift

let storyblok = URLSession(storyblok: .cdn(accessToken: "wANpEQEsMYGOwLxwXQ76Ggtt"))
var request = URLRequest(storyblok: storyblok, path: "stories")
request.url!.append(queryItems: [
    URLQueryItem(name: "cv", value: "1541863983")
])
let (data, _) = try await storyblok.data(for: request)
print(try JSONSerialization.jsonObject(with: data))

Kotlin

val client = HttpClient {
    install(Storyblok(CDN)) {
        accessToken = "wANpEQEsMYGOwLxwXQ76Ggtt"
    }
}

val response = client.get("stories") {
    url {
        parameters.append("cv", "1541863983")
    }
}

println(response.body<JsonElement>())