List collections
October 15, 2026 (November 16, 2026)
Table of contents
List the collections of your accounts. A collection is a folder that groups an account’s notebooks on the home page of the Gemini Notebook web app. Each one has a name, an optional emoji and the ids of its notebooks.
Create a collection with POST /collections. Rename it or add and remove notebooks with POST /collections/collection, and remove it with DELETE /collections/collection.
https://api.useapi.net/v1/gemini-notebook/collections?email=
Request Headers
Authorization: Bearer {API token}
API tokenis required, see Setup useapi.net for details.
Query Parameters
emailis optional, the account to list.
Default: every account of this API token. An account that cannot be read at the moment is left out of that list.
Responses
-
An account without collections returns
[].[ { "collection": "user:12345-user@example.com-collection:7f3b9e21-4c8a-4d6f-b2e5-1a9c0d8e6f43", "email": "user@example.com", "name": "Space history", "emoji": "🚀", "notebooks": [ "user:12345-user@example.com-notebook:d02c903b-17f8-4241-a263-2be9e7359d55" ] }, { "collection": "user:12345-user@example.com-collection:0a6d2c58-93e1-4b7f-8c4d-e25f17b9a306", "email": "user@example.com", "name": "Drafts", "notebooks": [] } ] -
{ "error": "Parameter email not a valid email", "code": 400 } -
Invalid API token.
{ "error": "useapi.net ⁝ Unauthorized", "code": 401 } -
The
emailis not one of your configured accounts.{ "error": "Account user@example.com is not configured", "code": 404 } -
596 Account Error
With
emailonly.Google reported the account as signed out. While we re-check it, the answer is the first message below. Retry in about a minute. If it stays signed out, the account is paused, you receive an email, and the answer becomes the second message until you re-add it via Setup Gemini Notebook.
{ "error": "Google reported this account as signed out. We are re-checking it — please retry in about a minute. If it stays signed out, you will receive a re-add email.", "code": 596 }{ "error": "Account user@example.com: Google signed this account out. Re-add it at https://useapi.net/docs/start-here/setup-gemini-notebook", "code": 596 } -
With
emailonly. Google is temporarily unavailable or is challenging our network. Retry in a few minutes. A502means Google answered with an unexpected error.{ "error": "GOOGLE_BOT_CHECK: Google is challenging our network right now, please retry in a few minutes", "code": 503 }
Model
An array of your accounts’ collections, each with its id, account, name, optional emoji and the ids of its notebooks.
The list of collections and the error answer, field by field
{ // TypeScript, all fields are optional
collection: string // user:<id>-<email>-collection:<collection id>
email: string // the account the collection belongs to
name: string
emoji?: string
notebooks: string[] // notebook ids in this collection
}[]
Errors return:
{
error: string
code: number // the HTTP status
}
Examples
-
curl -G "https://api.useapi.net/v1/gemini-notebook/collections" \ -H "Authorization: Bearer …" \ --data-urlencode "email=user@example.com" -
const token = "API token"; const email = "user@example.com"; const apiUrl = `https://api.useapi.net/v1/gemini-notebook/collections?email=${encodeURIComponent(email)}`; const response = await fetch(apiUrl, { headers: { "Authorization": `Bearer ${token}`, }, }); const result = await response.json(); console.log("response", {response, result}); -
import requests token = "API token" apiUrl = "https://api.useapi.net/v1/gemini-notebook/collections" headers = { "Authorization" : f"Bearer {token}" } response = requests.get(apiUrl, headers=headers, params={"email": "user@example.com"}) print(response, response.json())