Delete a note

September 29, 2026

Table of contents

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

Remove a note from its notebook on Google. A source made from the note with POST /notes/source is a separate copy and stays in the notebook. Remove it with DELETE /sources/source if you no longer need it.

https://api.useapi.net/v1/gemini-notebook/notes/note

  • note is required, the note id, URL-encoded in the path (it contains : and @). Note ids are returned by POST /notes and GET /notes. The id names its account, so no email is needed.
Request Headers 
Authorization: Bearer {API token}
Responses

  • 204 No Content

    The note was deleted. No body.

  • 400 Bad Request

    The path does not hold a valid note id, for example it holds a source id.

    {
  "error": "Path parameter note (user%3A12345-user%40example.com-source%3Ad02c903b-17f8-4241-a263-2be9e7359d55%3A10f43c6b-a0a6-46a8-b330-06a5718dffb2) is not a valid note id",
  "code": 400
}

  • 401 Unauthorized

    Invalid API token.

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

  • 403 Forbidden

    The note id was issued to a different API token.

    {
  "error": "user:[email protected]:d02c903b-17f8-4241-a263-2be9e7359d55:e5514ee8-22e5-414d-aa67-86e8476ece09 does not belong to this API token",
  "code": 403
}

  • 404 Not Found

    The account named in the note id is no longer configured, or Google reports the notebook as not found.

    {
  "error": "Account [email protected] of user:[email protected]:d02c903b-17f8-4241-a263-2be9e7359d55:e5514ee8-22e5-414d-aa67-86e8476ece09 is not configured",
  "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 [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

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

A successful delete returns 204 with no body. Errors return:

{ // TypeScript, all fields are optional
  error: string
  code: number
}
Examples 
  • NOTE="user:[email protected]:d02c903b-17f8-4241-a263-2be9e7359d55:e5514ee8-22e5-414d-aa67-86e8476ece09"
curl -X DELETE "https://api.useapi.net/v1/gemini-notebook/notes/$(python3 -c "import urllib.parse,sys;print(urllib.parse.quote(sys.argv[1],safe=''))" "$NOTE")" \
   -H "Authorization: Bearer …"

  • const token = "API token";
const note = "user:[email protected]:d02c903b-17f8-4241-a263-2be9e7359d55:e5514ee8-22e5-414d-aa67-86e8476ece09";
const apiUrl = `https://api.useapi.net/v1/gemini-notebook/notes/${encodeURIComponent(note)}`;
const response = await fetch(apiUrl, {
  method: "DELETE",
  headers: {
    "Authorization": `Bearer ${token}`,
  },
});
console.log("response", response.status);

  • import requests, urllib.parse
token = "API token"
note = "user:[email protected]:d02c903b-17f8-4241-a263-2be9e7359d55:e5514ee8-22e5-414d-aa67-86e8476ece09"
apiUrl = "https://api.useapi.net/v1/gemini-notebook/notes/" + urllib.parse.quote(note, safe="")
headers = {
    "Authorization" : f"Bearer {token}"
}
response = requests.delete(apiUrl, headers=headers)
print(response.status_code)
Try It