List collections

October 15, 2026

Table of contents

  1. Request Headers
  2. Query Parameters
  3. Responses
  4. Model
  5. Examples
  6. Try It

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=email

Request Headers 
Authorization: Bearer {API token}
Query Parameters
  • email is 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

  • 200 OK

    An account without collections returns [].

    [
  {
    "collection": "user:[email protected]:7f3b9e21-4c8a-4d6f-b2e5-1a9c0d8e6f43",
    "email": "[email protected]",
    "name": "Space history",
    "emoji": "🚀",
    "notebooks": [
      "user:[email protected]:d02c903b-17f8-4241-a263-2be9e7359d55"
    ]
  },
  {
    "collection": "user:[email protected]:0a6d2c58-93e1-4b7f-8c4d-e25f17b9a306",
    "email": "[email protected]",
    "name": "Drafts",
    "notebooks": []
  }
]

  • 400 Bad Request

    {
  "error": "Parameter email not a valid email",
  "code": 400
}

  • 401 Unauthorized

    Invalid API token.

    {
  "error": "useapi.net ⁝ Unauthorized",
  "code": 401
}

  • 404 Not Found

    The email is not one of your configured accounts.

    {
  "error": "Account [email protected] is not configured",
  "code": 404
}

  • 596 Account Error

    With email only.

    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 [email protected]: Google signed this account out. Re-add it at https://useapi.net/docs/start-here/setup-gemini-notebook",
  "code": 596
}

  • 503 Service Unavailable

    With email only. Google is temporarily unavailable or is challenging our network. Retry in a few minutes. A 502 means 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 
{ // 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 protected]"

  • const token = "API token";
const email = "[email protected]";
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": "[email protected]"})
print(response, response.json())
Try It