List collections

October 15, 2026 (November 16, 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: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": []
      }
    ]
    
  • 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 user@example.com 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 user@example.com: 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

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())
    
Try It