Observable

Workflows for creating content on Observable & sharing it with the world.

Sharing and Collaboration

👋🏼 I think it would be nice to include something here about personal vs team API Keys! I just spent a long time debugging a problem, where I couldn't download a notebook from my team with an API Key. Turns out that team notebooks needed to be "team shared" in order for me to use a "team API Key" to download it, but since it wasnt mentioned here I didnt think to check it

Alex Garcia

Hi, Alex, we added a note a few cells down about notebooks needing to be shared with the whole team for the API key to have access. Hope this addresses your suggestion.

Justin Ting

I wonder, what are the available options for the FORMAT field? It would be great to list those here.

Curran Kelleher

Is there a way to get the latest version, rather than specifying a particular version? If we must specify a version, is there a way to find out what that version is? Thanks!

Oh hey! It turns out that you can omit the version and the latest is fetched. Wonderful!

The supported formats are “js” and “tgz”.

Mike Bostock

Added note explicitly mentioning supported formats.

Hello! I'm trying to use the API key to embed private notebooks but it's returning "Not found." . What I tried doing is copying the same embed URL (as in the export option in the notebook) and adding to the link an additional argument for the API key: 
https://observablehq.com/embed/[notebook]?cells=[cell]&api_key=xxxx.

Am I doing it wrong? What link should we use for embedding cells with the API?

Lucas Tostes

Lucas, it looks like you are trying to embed a private notebook (with the API key) using the iframe embed method. Unfortunately that is not supported. The API key is only supported when you embed with JavaScript or React (the other options on the embed modal). 
We clarified that on the embed modal also.

Cobus Theunissen

I was under the impression that it would be possible to embed it using the iframe method too, but it's clear to me now.
Thank you very much, Cobus!