Update a collection
October 15, 2026 (November 16, 2026)
Table of contents
Rename a collection, change its emoji, or add notebooks to it and remove notebooks from it, in one request. A rename keeps the collection’s current emoji unless you send a new one. The collection id does not change. Removing a notebook from a collection does not delete the notebook.
Google takes one change per call, so the API sends them one after another: the name and emoji first, then each notebook to add, then each notebook to remove. If Google refuses a change after some went through, the call answers with Google’s error, and its message says how many changes were applied (for example (the first 2 of 3 changes were applied; GET /collections shows the collection now)). Check GET /collections before you send the rest again.
The response is the collection as stored after all changes.
https://api.useapi.net/v1/gemini-notebook/collections/
collection
collectionis required, the collection id from GET /collections or POST /collections, URL-encoded in the path (it contains:and@). The id names its account, so noemailis needed.
Request Headers
Authorization: Bearer {API token}
Content-Type: application/json
# Alternatively you can use multipart/form-data
# Content-Type: multipart/form-data
API tokenis required, see Setup useapi.net for details.
Request Body
{
"name": "Space history",
"emoji": "🚀",
"addNotebooks": [
"user:12345-user@example.com-notebook:d02c903b-17f8-4241-a263-2be9e7359d55"
]
}
nameis optional, the new name.
Length:1to100characters.emojiis optional, the new emoji.
Length:1to16characters.addNotebooksis optional, an array of1to100notebook ids of the collection’s account to add to the collection.removeNotebooksis optional, an array of1to100notebook ids to remove from the collection. The notebooks themselves stay.
Provide name, emoji, addNotebooks, removeNotebooks or any combination.
Responses
-
The collection after the change.
{ "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" ] } -
A malformed parameter, nothing to change, or a notebook on another account.
{ "error": "Provide name, emoji, addNotebooks and/or removeNotebooks", "code": 400 }{ "error": "notebook user:12345-other@example.com-notebook:5b7e2a41-9c0d-4e8f-a1b3-6d2c8f0e7a95 is on another account than collection user:12345-user@example.com-collection:7f3b9e21-4c8a-4d6f-b2e5-1a9c0d8e6f43", "code": 400 } -
Invalid API token.
{ "error": "useapi.net ⁝ Unauthorized", "code": 401 } -
The id was issued to a different API token.
{ "error": "user:12345-user@example.com-collection:7f3b9e21-4c8a-4d6f-b2e5-1a9c0d8e6f43 does not belong to this API token", "code": 403 } -
The collection no longer exists, or its account is no longer configured.
{ "error": "Collection user:12345-user@example.com-collection:7f3b9e21-4c8a-4d6f-b2e5-1a9c0d8e6f43 not found", "code": 404 } -
596 Account Error
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 } -
Google is temporarily unavailable or is challenging our network. Check GET /collections, then retry in a few minutes. A
502means 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
The collection as stored after all changes: its id, account, name, emoji and the ids of its notebooks.
The updated collection, field by field
{ // TypeScript, all fields are optional
collection: string // user:<id>-<email>-collection:<collection id>
email: string
name: string
emoji?: string
notebooks: string[] // notebook ids in this collection
error: string // error responses only
code: number // error responses only, the HTTP status
}
Examples
-
COLLECTION="user:12345-user@example.com-collection:7f3b9e21-4c8a-4d6f-b2e5-1a9c0d8e6f43" curl -X POST "https://api.useapi.net/v1/gemini-notebook/collections/$(python3 -c "import urllib.parse,sys;print(urllib.parse.quote(sys.argv[1],safe=''))" "$COLLECTION")" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer …" \ -d '{ "name": "Space history", "addNotebooks": ["user:12345-user@example.com-notebook:d02c903b-17f8-4241-a263-2be9e7359d55"] }' -
const token = "API token"; const collection = "user:12345-user@example.com-collection:7f3b9e21-4c8a-4d6f-b2e5-1a9c0d8e6f43"; const apiUrl = `https://api.useapi.net/v1/gemini-notebook/collections/${encodeURIComponent(collection)}`; const response = await fetch(apiUrl, { method: "POST", headers: { "Content-Type": "application/json", "Authorization": `Bearer ${token}`, }, body: JSON.stringify({ removeNotebooks: ["user:12345-user@example.com-notebook:d02c903b-17f8-4241-a263-2be9e7359d55"] }) }); const result = await response.json(); console.log("response", {response, result}); -
import requests, urllib.parse token = "API token" collection = "user:12345-user@example.com-collection:7f3b9e21-4c8a-4d6f-b2e5-1a9c0d8e6f43" apiUrl = "https://api.useapi.net/v1/gemini-notebook/collections/" + urllib.parse.quote(collection, safe="") headers = { "Content-Type": "application/json", "Authorization" : f"Bearer {token}" } data = { "emoji": "🌕" } response = requests.post(apiUrl, headers=headers, json=data) print(response, response.json())