Authentication

All requests to the Deep Review API must be authenticated and authorized. This page describes the supported OAuth 2.0 scopes, credentials, and Bring-Your-Own-Key (BYOK) Gemini API key options.

OAuth 2.0 Scopes

The Deep Review API is a public Google API and supports the following OAuth 2.0 scopes across all endpoints:

Scope Description
https://www.googleapis.com/auth/drive.file Authorizes managing manuscripts and reviews in the Deep Review API, as well as importing user-selected files from Google Drive.
https://www.googleapis.com/auth/cloud-platform Authorizes managing manuscripts and reviews in the Deep Review API using Google Cloud credentials.

Application Default Credentials (ADC)

For local development or testing scripts, set your active Google Cloud project, enable the Deep Review API, and configure Application Default Credentials with both the cloud-platform and drive.file scopes:

gcloud config set project YOUR_PROJECT_ID
gcloud services enable deepreview.googleapis.com
gcloud auth application-default login --scopes=https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/drive.file

When invoking REST endpoints directly, include your access token and billable project in request headers:

curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "x-goog-user-project: $(gcloud config get-value project)" \
     https://deepreview.googleapis.com/v1/documents

Bring Your Own Key (BYOK) Gemini API Key

If you prefer to bill LLM inference calls directly to your own Google AI Studio account, you can provide an optional geminiApiKey in the runConfig payload when calling CreateReview:

{
  "runConfig": {
    "topology": "MID",
    "geminiApiKey": "AIzaSy..."
  }
}