Export an artifact to Google Docs or Sheets

October 15, 2026 (November 16, 2026)

Table of contents

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

Save a finished Studio artifact as a new file in the Google Drive of the account that holds it, the Export menu of the Gemini Notebook web app. Reports become a Google Doc. Data tables become a Google Sheet. The response carries the link to the new file.

destination Artifact type Creates
docs report a Google Doc
sheets table a Google Sheet

Only a completed artifact can be exported. The new file belongs to the Google account that holds the notebook.

https://api.useapi.net/v1/gemini-notebook/artifacts/export

Request Headers
Authorization: Bearer {API token}
Content-Type: application/json
# Alternatively you can use multipart/form-data
# Content-Type: multipart/form-data
Request Body
{
  "artifact": "user:12345-user@example.com-artifact:d02c903b-17f8-4241-a263-2be9e7359d55:3c8b3e5e-4534-4430-aeb3-db347161a1ad",
  "destination": "docs",
  "title": "Apollo 11 briefing"
}
  • artifact is required, the artifact id from GET /artifacts or from the artifact field of a job. The id names its account and notebook, so no email is needed.
  • destination is required, where to export.
    Supported values: docs (for report), sheets (for table).
  • title is optional, the new file’s name, up to 200 characters.
    Default: the artifact’s title.
Responses
  • 201 Created

    A report exported to Google Docs:

    {
      "artifact": "user:12345-user@example.com-artifact:d02c903b-17f8-4241-a263-2be9e7359d55:3c8b3e5e-4534-4430-aeb3-db347161a1ad",
      "destination": "docs",
      "url": "https://docs.google.com/document/d/1AbCdEfGhIjKlMnOpQrStUvWxYz0123456789aBcDeF"
    }
    

    A data table exported to Google Sheets:

    {
      "artifact": "user:12345-user@example.com-artifact:d02c903b-17f8-4241-a263-2be9e7359d55:a92e5eee-f9a6-4640-906f-7b79b481e555",
      "destination": "sheets",
      "url": "https://docs.google.com/spreadsheets/d/1ZyXwVuTsRqPoNmLkJiHgFeDcBa9876543210zYxWvU/edit"
    }
    
  • 400 Bad Request

    A missing or invalid parameter, or a destination that does not take this artifact’s type.

    {
      "error": "destination sheets takes table (this one is report)",
      "code": 400
    }
    
    {
      "error": "Parameter destination (pdf) valid values: docs,sheets",
      "code": 400
    }
    
  • 401 Unauthorized

    Invalid API token.

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

    The artifact id belongs to a different API token.

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

    The artifact is no longer in its notebook, or the account it names is not configured.

    {
      "error": "Artifact user:12345-user@example.com-artifact:d02c903b-17f8-4241-a263-2be9e7359d55:3c8b3e5e-4534-4430-aeb3-db347161a1ad not found",
      "code": 404
    }
    
  • 409 Conflict

    The artifact has not completed.

    {
      "error": "Only a completed artifact can be exported (this one is processing)",
      "code": 409
    }
    
  • 502 Bad Gateway

    Google answered without a link to the new file. The file may exist anyway, so look in the account’s Google Drive before you export again.

    {
      "error": "Google answered the export without a document link: it may have been created anyway, check the account's Google Drive before retrying",
      "code": 502
    }
    
  • 503 Service Unavailable

    Google is temporarily unavailable or is challenging our network. Retry in a few minutes.

    {
      "error": "GOOGLE_BOT_CHECK: Google is challenging our network right now, please retry in a few minutes",
      "code": 503
    }
    
  • 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
    }
    
Model

The exported artifact’s id, the destination and the url of the new Google Doc or Sheet in the account’s Drive.

The exported artifact and its new Google file, field by field
{ // TypeScript, all fields are optional
  artifact: string             // the exported artifact's id
  destination: 'docs' | 'sheets'
  url: string                  // the new Google Doc or Sheet in the account's Google Drive
  error: string                // error responses only
  code: number                 // error responses only, the HTTP status
}
Examples
  • curl -X POST "https://api.useapi.net/v1/gemini-notebook/artifacts/export" \
       -H "Content-Type: application/json" \
       -H "Authorization: Bearer …" \
       -d '{
         "artifact": "user:12345-user@example.com-artifact:d02c903b-17f8-4241-a263-2be9e7359d55:3c8b3e5e-4534-4430-aeb3-db347161a1ad",
         "destination": "docs",
         "title": "Apollo 11 briefing"
       }'
    
  • const token = "API token";
    const artifact = "user:12345-user@example.com-artifact:...";
    const response = await fetch("https://api.useapi.net/v1/gemini-notebook/artifacts/export", {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        "Authorization": `Bearer ${token}`
      },
      body: JSON.stringify({ artifact, destination: "sheets" })
    });
    const result = await response.json();
    console.log("response", response.status, result);
    
  • import requests
    
    token = "API token"
    artifact = "user:12345-user@example.com-artifact:..."
    response = requests.post(
        "https://api.useapi.net/v1/gemini-notebook/artifacts/export",
        headers={"Content-Type": "application/json", "Authorization": f"Bearer {token}"},
        json={"artifact": artifact, "destination": "docs", "title": "Apollo 11 briefing"}
    )
    print(response.status_code, response.json())
    
Try It