# 1.3 Basic Setup

The minimal requirement for the extension to run is the formulation of a **data request**. Here's a basic example, which requests all the items in your personal library :

```javascript
// The zoteroRoam_settings object will contain all your settings for the extension
// For now, we're doing a minimal configuration, with just a single data request.
// Paste this into your roam/js block, and fill out the API key + your user ID :

zoteroRoam_settings = {
    dataRequests: {
        apikey: "your_API_key",
        dataURI: "users/your_user_id/items",
        params: "limit=100"
    }
}
```

After you've done this, reload your graph. A new icon should be visible in the topbar - a book :

![The book (right) is the extension's icon](/files/-MVO4jBkP1LrfCqTHrT3)

The icon acts as a toggle for turning the extension on/off, and its background color always indicates the current state of the extension :

* <img src="/files/-MVPCylIWt8X-uvOJa1_" alt="" data-size="original"> **Busy** - the data request is ongoing. Depending on the number of items, this may take \~20s.
* <img src="/files/-MVPCNuEocBAOovwBPj5" alt="" data-size="original">  **Active** - the data has been fully loaded, the extension is ready !
* <img src="/files/-MVPDi6laFCaOy0_PAKs" alt="" data-size="original">  **Error** - something went wrong while retrieving the data. Check the browser console for details.
* <img src="/files/-MVPCfbcaY7KxpFNiaSX" alt="" data-size="original"> The extension is turned off.

Once the icon turns green, the extension's functionalities will become available.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://alix-lahuec.gitbook.io/zotero-roam/v0.6/getting-started/api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
