Delete chat history

September 29, 2026

Table of contents

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

Delete a chat conversation, the “Delete history” action of the Gemini Notebook web app. The next POST /chat question without a conversation starts a new conversation. Notes saved from the chat and the notebook’s sources are not touched.

Without conversation the notebook’s latest conversation is deleted, and the call answers 404 when the notebook has none.

https://api.useapi.net/v1/gemini-notebook/chat?notebook=notebook&conversation=conversation

Request Headers 
Authorization: Bearer {API token}
Query Parameters
  • notebook is required, the notebook id returned by POST /notebooks or GET /notebooks. URL-encode it (it contains : and @). The id names its account, so no email is needed.
  • conversation is optional, a conversation id from POST /chat.
    Default: the notebook’s latest conversation.
Responses

  • 204 No Content

    The conversation was deleted. No body.

  • 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:[email protected]:d02c903b-17f8-4241-a263-2be9e7359d55 does not belong to this API token",
  "code": 403
}

  • 404 Not Found

    Without conversation, the notebook has no conversation to delete. Also returned when the notebook was deleted or its account is no longer configured.

    {
  "error": "The notebook has no conversation to delete",
  "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 (J7Gthc 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 
  • curl -X DELETE -G "https://api.useapi.net/v1/gemini-notebook/chat" \
   -H "Authorization: Bearer …" \
   --data-urlencode "notebook=user:[email protected]:d02c903b-17f8-4241-a263-2be9e7359d55"

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

  • import requests
token = "API token"
notebook = "user:[email protected]:d02c903b-17f8-4241-a263-2be9e7359d55"
apiUrl = "https://api.useapi.net/v1/gemini-notebook/chat"
headers = {
    "Authorization" : f"Bearer {token}"
}
response = requests.delete(apiUrl, headers=headers, params={"notebook": notebook, "conversation": "fd20f12d-611f-4008-9e61-94e02af005a9"})
print(response.status_code)
Try It