🏠 back to Observable

Is ?v=3 correct when requesting notebook js?

#1

Hi! My goal is to get a notebook running on a static webpage. I’ve been poking around, but I’m wondering if I can confirm a thing or two about the observable runtime.

While working through the runtime example I made the mistake of removing ?v=3 from a request to https://api.observablehq.com/@tmcw/hello-world.js?v=3, having mistakenly thought maybe v corresponded to the runtime version. Am I correct in understanding:

  • ?v=1: returns a deprecated notebook format (requires runtime.load()?)
  • ?v=3: returns the currently preferred format
  • ?[blank]: equivalent to ?v=1

Long story short, is it correct to use runtime v4 along with ?v=3?

1 Like
#2

Yep! Use the v=3 format with the latest version of the runtime. Sorry for the confusion—we are in a slightly awkward spot where we haven’t quite finished the migration to the new format.

1 Like
#3

Just curious: do you plan to keep v1 API support for the foreseeable future? Just debating whether to build on it (it’s a bit easier at the moment) or whether to figure out v3 now to prevent breakage. Thanks!

#4

It’ll keep working for the foreseeable future, but we’d love to understand your use case better. What makes v1 easier for you?