List source labels

September 29, 2026 (November 16, 2026)

Table of contents

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

List the labels that group a notebook’s sources, as the source panel of the Gemini Notebook web app shows them. Each label has a name, an optional emoji and the ids of its sources. A source can be in more than one label, and sources without a label are not listed here.

Create labels with POST /labels, either by letting Google label the sources by topic or by naming one yourself. Change one with POST /labels/label and remove it with DELETE /labels/label.

https://api.useapi.net/v1/gemini-notebook/labels?notebook=notebook

Request Headers
Authorization: Bearer {API token}
Query Parameters
  • notebook is required, the notebook id returned by POST /notebooks or GET /notebooks, for example user:12345-user@example.com-notebook:d02c903b-17f8-4241-a263-2be9e7359d55.
    The id names the account the notebook lives on, so no email parameter is needed. URL-encode it (it contains : and @).
Responses
  • 200 OK

    A notebook without labels returns "labels": [].

    {
      "notebook": "user:12345-user@example.com-notebook:d02c903b-17f8-4241-a263-2be9e7359d55",
      "labels": [
        {
          "label": "user:12345-user@example.com-label:d02c903b-17f8-4241-a263-2be9e7359d55:01a0466f-bd9f-48ab-a27d-5ae84181aa42",
          "name": "Apollo 11 Mission",
          "sources": [
            "user:12345-user@example.com-source:d02c903b-17f8-4241-a263-2be9e7359d55:1761af94-f5aa-47f3-9539-0b4ebcd547f8",
            "user:12345-user@example.com-source:d02c903b-17f8-4241-a263-2be9e7359d55:2744eb7c-399a-4573-bd32-126143ba9514"
          ]
        },
        {
          "label": "user:12345-user@example.com-label:d02c903b-17f8-4241-a263-2be9e7359d55:5973ba2b-845e-41b5-97b2-ef855d5746ad",
          "name": "The landing",
          "emoji": "🚀",
          "sources": []
        }
      ]
    }
    
  • 400 Bad Request

    {
      "error": "Parameter notebook is required",
      "code": 400
    }
    
  • 401 Unauthorized

    Invalid API token.

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

    The id was issued to a different API token.

    {
      "error": "user:12345-user@example.com-notebook:d02c903b-17f8-4241-a263-2be9e7359d55 does not belong to this API token",
      "code": 403
    }
    
  • 404 Not Found

    The notebook was deleted, or its account is no longer configured.

    {
      "error": "Not found on account user@example.com (Google I3xc3c grpc 5)",
      "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
    }
    
  • 503 Service Unavailable

    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 is temporarily unavailable (I3xc3c grpc 14), please retry",
      "code": 503
    }
    
Model

The notebook’s labels, each with its id, name, optional emoji and the ids of the sources it groups.

The notebook's source labels, field by field
{ // TypeScript, all fields are optional
  notebook: string
  labels: {
    label: string              // user:<id>-<email>-label:<notebook uuid>:<label uuid>
    name: string
    emoji?: string
    sources: string[]          // source ids with this label
  }[]
  error: string                // error responses only
  code: number                 // error responses only, the HTTP status
}
Examples
  • curl -G "https://api.useapi.net/v1/gemini-notebook/labels" \
       -H "Authorization: Bearer …" \
       --data-urlencode "notebook=user:12345-user@example.com-notebook:d02c903b-17f8-4241-a263-2be9e7359d55"
    
  • const token = "API token";
    const notebook = "user:12345-user@example.com-notebook:d02c903b-17f8-4241-a263-2be9e7359d55";
    const apiUrl = `https://api.useapi.net/v1/gemini-notebook/labels?notebook=${encodeURIComponent(notebook)}`;
    const response = await fetch(apiUrl, {
      headers: {
        "Authorization": `Bearer ${token}`,
      },
    });
    const result = await response.json();
    console.log("response", {response, result});
    
  • import requests
    token = "API token"
    notebook = "user:12345-user@example.com-notebook:d02c903b-17f8-4241-a263-2be9e7359d55"
    apiUrl = "https://api.useapi.net/v1/gemini-notebook/labels"
    headers = {
        "Authorization" : f"Bearer {token}"
    }
    response = requests.get(apiUrl, headers=headers, params={"notebook": notebook})
    print(response, response.json())
    
Try It