{"openapi":"3.0.0","info":{"description":"Google's Gemini API (v1beta) for building generative AI applications with multimodal Gemini models — text, image, audio, video and code generation, plus managed agents, voices, batch, caching and file search. v1beta is the early-access version: the API surface may change at any time.","version":[{"name":"v1beta","value":"v1beta"}]},"servers":[{"description":"Google's Gemini API (v1beta) for building generative AI applications with multimodal Gemini models — text, image, audio, video and code generation, plus managed agents, voices, batch, caching and file search. v1beta is the early-access version: the API surface may change at any time.","url":"https://api.apirails.com/googlegemini"}],"paths":{"/v1beta/models":{"get":{"tags":["Models"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/models#v1beta.models.list","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/models"},"summary":"List Models","description":"Lists the Models available through the Gemini API","security":[{"bearerAuth":[]}]}},"/v1beta/models/{name}":{"get":{"tags":["Models"],"parameters":[{"name":"name","in":"path","description":"The name of the model. Format: models/{model}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/models#v1beta.models.get","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/models/{name}"},"summary":"Get Model","description":"Gets information about a specific Model such as its version number, token limits, parameters and other metadata","security":[{"bearerAuth":[]}]}},"/v1beta/models/{model}/generateContent":{"post":{"tags":["Content Generation"],"parameters":[{"name":"model","in":"path","description":"The name of the model to use. Format: models/{model}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/generate-content#v1beta.models.generateContent","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/models/{model}:generateContent"},"summary":"Generate Content","description":"Generates a model response given an input GenerateContentRequest. Returns the full response in a single package","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"cachedContent":{"type":"string","description":"Optional. The name of the cached content to use as context"},"contents":{"type":"array","description":"The contents of the current conversation with the model. A list of Content objects, each representing a turn in the conversation","required":true,"items":{"type":"string"}},"generationConfig":{"type":"object","description":"Optional. Configuration options for model generation and output","properties":{"candidateCount":{"type":"number","description":"Number of generated response candidates to return"},"maxOutputTokens":{"type":"number","description":"Maximum number of tokens to generate in the response"},"stopSequences":{"type":"array","description":"A list of stop sequences. The API will stop at the first stop sequence it encounters"},"temperature":{"type":"number","description":"Controls the randomness of the output. Values can range from 0.0 to 2.0"},"topK":{"type":"number","description":"Top-k changes how the model selects tokens for output. A top-k of 1 means the selected token is the most probable among all tokens"},"topP":{"type":"number","description":"Top-p changes how the model selects tokens for output. Tokens are selected from most probable to least until the sum of their probabilities equals the top-p value"}}},"safetySettings":{"type":"array","description":"Optional. A list of unique SafetySetting instances for blocking unsafe content","items":{"type":"string"}},"serviceTier":{"type":"string","description":"Optional. Service tier (unspecified, standard, flex, priority)"},"store":{"type":"boolean","description":"Optional. Configures logging behavior for the request","enum":[true,false]},"systemInstruction":{"type":"object","description":"Optional. Developer-set system instruction for the model","properties":{}},"toolConfig":{"type":"object","description":"Optional. Tool configuration for the request","properties":{}},"tools":{"type":"array","description":"Optional. A list of Tools the model may use to generate the next response","items":{"type":"string"}}}},"example":{"cachedContent":"","contents":[{"parts":[{"text":"Explain how AI works in a few words"}],"role":"user"}],"generationConfig":{},"safetySettings":[],"serviceTier":"","store":"","systemInstruction":{},"toolConfig":{},"tools":[]}}}}}},"/v1beta/models/{model}/streamGenerateContent":{"post":{"tags":["Content Generation"],"parameters":[{"name":"model","in":"path","description":"The name of the model to use. Format: models/{model}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/generate-content#v1beta.models.streamGenerateContent","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/models/{model}:streamGenerateContent"},"summary":"Stream Generate Content","description":"Generates a streamed response from the model given an input GenerateContentRequest. Uses Server-Sent Events (SSE) to push chunks of the response as they are generated","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"cachedContent":{"type":"string","description":"Optional. The name of the cached content to use as context"},"contents":{"type":"array","description":"The contents of the current conversation with the model. A list of Content objects, each representing a turn in the conversation","required":true,"items":{"type":"string"}},"generationConfig":{"type":"object","description":"Optional. Configuration options for model generation and output","properties":{}},"safetySettings":{"type":"array","description":"Optional. A list of unique SafetySetting instances for blocking unsafe content","items":{"type":"string"}},"serviceTier":{"type":"string","description":"Optional. Service tier (unspecified, standard, flex, priority)"},"store":{"type":"boolean","description":"Optional. Configures logging behavior for the request","enum":[true,false]},"systemInstruction":{"type":"object","description":"Optional. Developer-set system instruction for the model","properties":{}},"toolConfig":{"type":"object","description":"Optional. Tool configuration for the request","properties":{}},"tools":{"type":"array","description":"Optional. A list of Tools the model may use to generate the next response","items":{"type":"string"}}}},"example":{"cachedContent":"","contents":[],"generationConfig":{},"safetySettings":[],"serviceTier":"","store":"","systemInstruction":{},"toolConfig":{},"tools":[]}}}}}},"/v1beta/models/{model}/embedContent":{"post":{"tags":["Embeddings"],"parameters":[{"name":"model","in":"path","description":"The name of the embedding model to use. Format: models/{model}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/embeddings#v1beta.models.embedContent","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/models/{model}:embedContent"},"summary":"Embed Content","description":"Generates a text embedding vector from the input Content using the specified Gemini Embedding model","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"content":{"type":"object","description":"The content to embed. Only the parts field is counted. It can have a maximum of 50 parts","required":true,"properties":{}},"outputDimensionality":{"type":"number","description":"Optional. Reduced dimension for the output embedding"},"taskType":{"type":"string","description":"Optional. Optional task type for getting the embedding","enum":["TASK_TYPE_UNSPECIFIED","RETRIEVAL_QUERY","RETRIEVAL_DOCUMENT","SEMANTIC_SIMILARITY","CLASSIFICATION","CLUSTERING","QUESTION_ANSWERING","FACT_VERIFICATION","CODE_RETRIEVAL_QUERY"]},"title":{"type":"string","description":"Optional. An optional title for the text. Only applicable when task_type is RETRIEVAL_DOCUMENT"}}},"example":{"content":{},"outputDimensionality":"","taskType":"","title":""}}}}}},"/v1beta/models/{model}/batchEmbedContents":{"post":{"tags":["Embeddings"],"parameters":[{"name":"model","in":"path","description":"The name of the embedding model to use. Format: models/{model}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/embeddings#v1beta.models.batchEmbedContents","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/models/{model}:batchEmbedContents"},"summary":"Batch Embed Contents","description":"Generates multiple embedding vectors from the input Content which consists of a batch of strings represented as EmbedContentRequest objects","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"requests":{"type":"array","description":"Required. Embed requests. The model supports a maximum of 2048 requests","required":true,"items":{"type":"string"}}}},"example":{"requests":[]}}}}}},"/v1beta/models/{model}/asyncBatchEmbedContent":{"post":{"tags":["Embeddings"],"parameters":[{"name":"model","in":"path","description":"The name of the embedding model to use. Format: models/{model}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/embeddings#v1beta.models.asyncBatchEmbedContent","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/models/{model}:asyncBatchEmbedContent"},"summary":"Async Batch Embed Content","description":"Enqueues a batch of EmbedContent requests for batch processing","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"requests":{"type":"array","description":"Required. Embed requests for batch processing","required":true,"items":{"type":"string"}}}},"example":{"requests":[]}}}}}},"/v1beta/models/{model}/countTokens":{"post":{"tags":["Tokens"],"parameters":[{"name":"model","in":"path","description":"The name of the model to use. Format: models/{model}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/tokens#v1beta.models.countTokens","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/models/{model}:countTokens"},"summary":"Count Tokens","description":"Runs a model's tokenizer on input Content and returns the token count","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"contents":{"type":"array","description":"Optional. The contents to count tokens for","items":{"type":"string"}}}},"example":{"contents":[]}}}}}},"/v1beta/models/{model}/computeTokens":{"post":{"tags":["Tokens"],"parameters":[{"name":"model","in":"path","description":"The name of the model to use. Format: models/{model}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/tokens#v1beta.models.computeTokens","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/models/{model}:computeTokens"},"summary":"Compute Tokens","description":"Computes token information for the input content including token count and token list for multimodal content","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"contents":{"type":"array","description":"Required. The content to compute tokens for","required":true,"items":{"type":"string"}}}},"example":{"contents":[]}}}}}},"/v1beta/files":{"get":{"tags":["Files"],"parameters":[{"name":"pageSize","in":"query","description":"Optional. The maximum number of Files to return per page","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"Optional. A page token, received from a previous ListFiles call","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/files#v1beta.files.list","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/files"},"summary":"List Files","description":"Lists the metadata for Files owned by the requesting project","security":[{"bearerAuth":[]}]}},"/v1beta/files/{name}":{"get":{"tags":["Files"],"parameters":[{"name":"name","in":"path","description":"The name of the File resource. Format: files/{file}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/files#v1beta.files.get","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/files/{name}"},"summary":"Get File","description":"Gets the metadata for the given File","security":[{"bearerAuth":[]}]},"delete":{"tags":["Files"],"parameters":[{"name":"name","in":"path","description":"The name of the File resource. Format: files/{file}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/files#v1beta.files.delete","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/files/{name}"},"summary":"Delete File","description":"Deletes the File","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/upload/v1beta/files":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/files#v1beta.media.upload","api_endpoint":"https://generativelanguage.googleapis.com/upload/v1beta/files"},"summary":"Upload File","description":"Creates a File by uploading data from the user's device","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{"file":{"type":"string","format":"binary","description":"The file to upload","required":true},"file.displayName":{"type":"string","description":"Optional. Display name of the file"}}},"example":{"file":"(binary)","file.displayName":""}}}}}},"/v1beta/cachedContents":{"post":{"tags":["Caching"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/caching#v1beta.cachedContents.create","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/cachedContents"},"summary":"Create Cached Content","description":"Creates CachedContent resource","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"contents":{"type":"array","description":"Required. Immutable. The content to cache","required":true,"items":{"type":"string"}},"model":{"type":"string","description":"Required. Immutable. The name of the model to use. Format: models/{model}","required":true},"systemInstruction":{"type":"object","description":"Optional. Immutable. System instruction to cache","properties":{}},"ttl":{"type":"string","description":"Optional. Expiration time in seconds. Defaults to 3600 (1 hour). Maximum is 604800 (7 days)"}}},"example":{"contents":[],"model":"","systemInstruction":{},"ttl":""}}}}},"get":{"tags":["Caching"],"parameters":[{"name":"pageSize","in":"query","description":"Optional. The maximum number of CachedContents to return per page","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"Optional. A page token, received from a previous ListCachedContents call","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/caching#v1beta.cachedContents.list","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/cachedContents"},"summary":"List Cached Contents","description":"Lists CachedContents","security":[{"bearerAuth":[]}]}},"/v1beta/cachedContents/{name}":{"get":{"tags":["Caching"],"parameters":[{"name":"name","in":"path","description":"The name of the CachedContent resource. Format: cachedContents/{cached_content}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/caching#v1beta.cachedContents.get","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/cachedContents/{name}"},"summary":"Get Cached Content","description":"Reads CachedContent resource","security":[{"bearerAuth":[]}]},"delete":{"tags":["Caching"],"parameters":[{"name":"name","in":"path","description":"The name of the CachedContent resource. Format: cachedContents/{cached_content}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/caching#v1beta.cachedContents.delete","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/cachedContents/{name}"},"summary":"Delete Cached Content","description":"Deletes CachedContent resource","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"patch":{"tags":["Caching"],"parameters":[{"name":"name","in":"path","description":"The name of the CachedContent resource. Format: cachedContents/{cached_content}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/caching#v1beta.cachedContents.patch","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/cachedContents/{name}"},"summary":"Patch Cached Content","description":"Updates CachedContent resource (only expiration is updatable)","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"ttl":{"type":"string","description":"Optional. Expiration time in seconds. Only expiration is updatable"}}},"example":{"ttl":""}}}}}},"/v1beta/models/{model}/batchGenerateContent":{"post":{"tags":["Batch"],"parameters":[{"name":"model","in":"path","description":"The name of the model to use. Format: models/{model}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/batch-api#v1beta.models.batchGenerateContent","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/models/{model}:batchGenerateContent"},"summary":"Batch Generate Content","description":"Enqueues a batch of GenerateContent requests for batch processing","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"requests":{"type":"array","description":"Required. The requests to process in batch","required":true,"items":{"type":"string"}}}},"example":{"requests":[]}}}}}},"/v1beta/batches/{name}":{"get":{"tags":["Batch"],"parameters":[{"name":"name","in":"path","description":"The name of the batch operation. Format: batches/{batch}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/batch-api#v1beta.batches.get","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/batches/{name}"},"summary":"Get Batch","description":"Gets the latest state of a long-running operation","security":[{"bearerAuth":[]}]},"delete":{"tags":["Batch"],"parameters":[{"name":"name","in":"path","description":"The name of the batch operation. Format: batches/{batch}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/batch-api#v1beta.batches.delete","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/batches/{name}"},"summary":"Delete Batch","description":"Deletes a long-running operation","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1beta/batches":{"get":{"tags":["Batch"],"parameters":[{"name":"filter","in":"query","description":"Optional. Filter for batch operations","schema":{"type":"string","example":""}},{"name":"pageSize","in":"query","description":"Optional. The maximum number of batches to return per page","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"Optional. A page token, received from a previous ListBatches call","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/batch-api#v1beta.batches.list","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/batches"},"summary":"List Batches","description":"Lists operations that match the specified filter in the request","security":[{"bearerAuth":[]}]}},"/v1beta/batches/{name}/cancel":{"post":{"tags":["Batch"],"parameters":[{"name":"name","in":"path","description":"The name of the batch operation. Format: batches/{batch}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/batch-api#v1beta.batches.cancel","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/batches/{name}:cancel"},"summary":"Cancel Batch","description":"Starts asynchronous cancellation on a long-running operation","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1beta/batches/{name}/updateGenerateContentBatch":{"patch":{"tags":["Batch"],"parameters":[{"name":"name","in":"path","description":"The name of the batch operation. Format: batches/{batch}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/batch-api#v1beta.batches.updateGenerateContentBatch","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/batches/{name}:updateGenerateContentBatch"},"summary":"Update Generate Content Batch","description":"Updates a batch of GenerateContent requests for batch processing","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"requests":{"type":"array","description":"Optional. Updated requests for the batch","items":{"type":"string"}}}},"example":{"requests":[]}}}}}},"/v1beta/batches/{name}/updateEmbedContentBatch":{"patch":{"tags":["Batch"],"parameters":[{"name":"name","in":"path","description":"The name of the batch operation. Format: batches/{batch}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/batch-api#v1beta.batches.updateEmbedContentBatch","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/batches/{name}:updateEmbedContentBatch"},"summary":"Update Embed Content Batch","description":"Updates a batch of EmbedContent requests for batch processing","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"requests":{"type":"array","description":"Optional. Updated requests for the batch","items":{"type":"string"}}}},"example":{"requests":[]}}}}}},"/v1beta/tunedModels":{"post":{"tags":["Tuning"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/tuning#v1beta.tunedModels.create","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/tunedModels"},"summary":"Create Tuned Model","description":"Creates a tuned model using the provided training data","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"baseModel":{"type":"string","description":"Required. The name of the base model to tune. Format: models/{model}","required":true},"description":{"type":"string","description":"Optional. The description of the tuned model"},"displayName":{"type":"string","description":"Optional. The display name of the tuned model"},"tuningTask":{"type":"object","description":"Required. The tuning task configuration including training data","required":true,"properties":{}}}},"example":{"baseModel":"","description":"","displayName":"","tuningTask":{}}}}}},"get":{"tags":["Tuning"],"parameters":[{"name":"filter","in":"query","description":"Optional. Filter for tuned models","schema":{"type":"string","example":""}},{"name":"pageSize","in":"query","description":"Optional. The maximum number of tuned models to return per page","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"Optional. A page token, received from a previous ListTunedModels call","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/tuning#v1beta.tunedModels.list","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/tunedModels"},"summary":"List Tuned Models","description":"Lists tuned models owned by the user","security":[{"bearerAuth":[]}]}},"/v1beta/tunedModels/{name}":{"get":{"tags":["Tuning"],"parameters":[{"name":"name","in":"path","description":"The name of the tuned model. Format: tunedModels/{tuned_model}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/tuning#v1beta.tunedModels.get","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/tunedModels/{name}"},"summary":"Get Tuned Model","description":"Gets information about a specific tuned model","security":[{"bearerAuth":[]}]},"delete":{"tags":["Tuning"],"parameters":[{"name":"name","in":"path","description":"The name of the tuned model. Format: tunedModels/{tuned_model}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/tuning#v1beta.tunedModels.delete","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/tunedModels/{name}"},"summary":"Delete Tuned Model","description":"Deletes a tuned model","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"patch":{"tags":["Tuning"],"parameters":[{"name":"name","in":"path","description":"The name of the tuned model. Format: tunedModels/{tuned_model}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/tuning#v1beta.tunedModels.patch","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/tunedModels/{name}"},"summary":"Update Tuned Model","description":"Updates a tuned model's metadata","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"description":{"type":"string","description":"Optional. The description of the tuned model"},"displayName":{"type":"string","description":"Optional. The display name of the tuned model"}}},"example":{"description":"","displayName":""}}}}}},"/v1beta/tunedModels/{name}/transfer":{"post":{"tags":["Tuning"],"parameters":[{"name":"name","in":"path","description":"The name of the tuned model. Format: tunedModels/{tuned_model}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/tuning#v1beta.tunedModels.transfer","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/tunedModels/{name}:transfer"},"summary":"Transfer Tuned Model","description":"Transfers ownership of a tuned model to another user","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"clientEmail":{"type":"string","description":"Required. The email of the user to transfer ownership to","required":true}}},"example":{"clientEmail":""}}}}}},"/v1beta/{parent}/permissions":{"get":{"tags":["Permissions"],"parameters":[{"name":"parent","in":"path","description":"The parent resource. Format: tunedModels/{tuned_model} or corpora/{corpus}","required":true,"schema":{"type":"string","example":""}},{"name":"pageSize","in":"query","description":"Optional. The maximum number of permissions to return per page","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"Optional. A page token, received from a previous ListPermissions call","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/permissions#v1beta.permissions.list","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/{parent}/permissions"},"summary":"List Permissions","description":"Lists permissions for a resource","security":[{"bearerAuth":[]}]},"post":{"tags":["Permissions"],"parameters":[{"name":"parent","in":"path","description":"The parent resource. Format: tunedModels/{tuned_model} or corpora/{corpus}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/permissions#v1beta.permissions.create","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/{parent}/permissions"},"summary":"Create Permission","description":"Creates a permission for a resource","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"emailAddress":{"type":"string","description":"Optional. The email address of the grantee (for USER or GROUP)"},"granteeType":{"type":"string","description":"Required. The type of grantee (USER, GROUP, EVERYONE)","required":true,"enum":["GRANTEE_TYPE_UNSPECIFIED","USER","GROUP","EVERYONE"]},"role":{"type":"string","description":"Required. The role to grant (READER, WRITER, OWNER)","required":true,"enum":["ROLE_UNSPECIFIED","READER","WRITER","OWNER"]}}},"example":{"emailAddress":"","granteeType":"","role":""}}}}}},"/v1beta/{parent}/permissions/{permission}":{"get":{"tags":["Permissions"],"parameters":[{"name":"parent","in":"path","description":"The parent resource. Format: tunedModels/{tuned_model} or corpora/{corpus}","required":true,"schema":{"type":"string","example":""}},{"name":"permission","in":"path","description":"The permission ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/permissions#v1beta.permissions.get","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/{parent}/permissions/{permission}"},"summary":"Get Permission","description":"Gets information about a specific permission","security":[{"bearerAuth":[]}]}},"/v1beta/{name}/permissions/{permission}":{"delete":{"tags":["Permissions"],"parameters":[{"name":"name","in":"path","description":"The parent resource. Format: tunedModels/{tuned_model} or corpora/{corpus}","required":true,"schema":{"type":"string","example":""}},{"name":"permission","in":"path","description":"The permission ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/permissions#v1beta.permissions.delete","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/{name}/permissions/{permission}"},"summary":"Delete Permission","description":"Deletes a permission","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"patch":{"tags":["Permissions"],"parameters":[{"name":"name","in":"path","description":"The parent resource. Format: tunedModels/{tuned_model} or corpora/{corpus}","required":true,"schema":{"type":"string","example":""}},{"name":"permission","in":"path","description":"The permission ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/permissions#v1beta.permissions.patch","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/{name}/permissions/{permission}"},"summary":"Update Permission","description":"Updates a permission's role","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"role":{"type":"string","description":"Required. The role to grant (READER, WRITER, OWNER)","required":true,"enum":["ROLE_UNSPECIFIED","READER","WRITER","OWNER"]}}},"example":{"role":""}}}}}},"/v1beta/fileSearchStores":{"post":{"tags":["File Search"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/file-search/file-search-stores#v1beta.fileSearchStores.create","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/fileSearchStores"},"summary":"Create File Search Store","description":"Creates an empty FileSearchStore","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"displayName":{"type":"string","description":"Optional. Display name for the FileSearchStore"}}},"example":{"displayName":""}}}}},"get":{"tags":["File Search"],"parameters":[{"name":"pageSize","in":"query","description":"Optional. The maximum number of FileSearchStores to return per page","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"Optional. A page token, received from a previous ListFileSearchStores call","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/file-search/file-search-stores#v1beta.fileSearchStores.list","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/fileSearchStores"},"summary":"List File Search Stores","description":"Lists all FileSearchStores owned by the user","security":[{"bearerAuth":[]}]}},"/v1beta/fileSearchStores/{name}":{"get":{"tags":["File Search"],"parameters":[{"name":"name","in":"path","description":"The name of the FileSearchStore. Format: fileSearchStores/{file_search_store}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/file-search/file-search-stores#v1beta.fileSearchStores.get","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/fileSearchStores/{name}"},"summary":"Get File Search Store","description":"Gets information about a specific FileSearchStore","security":[{"bearerAuth":[]}]},"delete":{"tags":["File Search"],"parameters":[{"name":"name","in":"path","description":"The name of the FileSearchStore. Format: fileSearchStores/{file_search_store}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/file-search/file-search-stores#v1beta.fileSearchStores.delete","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/fileSearchStores/{name}"},"summary":"Delete File Search Store","description":"Deletes a FileSearchStore","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1beta/fileSearchStores/{fileSearchStoreName}/importFile":{"post":{"tags":["File Search"],"parameters":[{"name":"fileSearchStoreName","in":"path","description":"The name of the FileSearchStore. Format: fileSearchStores/{file_search_store}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/file-search/file-search-stores#v1beta.fileSearchStores.importFile","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/fileSearchStores/{fileSearchStoreName}:importFile"},"summary":"Import File to File Search Store","description":"Imports a File from File Service to a FileSearchStore","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"file":{"type":"string","description":"Required. The name of the File to import. Format: files/{file}","required":true}}},"example":{"file":""}}}}}},"/upload/v1beta/fileSearchStores/{fileSearchStoreName}/uploadToFileSearchStore":{"post":{"tags":["File Search"],"parameters":[{"name":"fileSearchStoreName","in":"path","description":"The name of the FileSearchStore. Format: fileSearchStores/{file_search_store}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/file-search/file-search-stores#v1beta.media.uploadToFileSearchStore","api_endpoint":"https://generativelanguage.googleapis.com/upload/v1beta/fileSearchStores/{fileSearchStoreName}:uploadToFileSearchStore"},"summary":"Upload to File Search Store","description":"Uploads data to a FileSearchStore, preprocesses and chunks before storing it in a FileSearchStore Document","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{"file":{"type":"string","format":"binary","description":"The file to upload","required":true}}},"example":{"file":"(binary)"}}}}}},"/v1beta/fileSearchStores/{parent}/documents":{"get":{"tags":["File Search"],"parameters":[{"name":"parent","in":"path","description":"The parent FileSearchStore. Format: fileSearchStores/{file_search_store}","required":true,"schema":{"type":"string","example":""}},{"name":"pageSize","in":"query","description":"Optional. The maximum number of Documents to return per page","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"Optional. A page token, received from a previous ListDocuments call","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/file-search/documents#v1beta.fileSearchStores.documents.list","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/fileSearchStores/{parent}/documents"},"summary":"List Documents","description":"Lists all Documents in a FileSearchStore","security":[{"bearerAuth":[]}]}},"/v1beta/fileSearchStores/{name}/documents/{document}":{"get":{"tags":["File Search"],"parameters":[{"name":"document","in":"path","description":"The Document ID (the `documents/{document}` segment value)","required":true,"schema":{"type":"string","example":""}},{"name":"name","in":"path","description":"The FileSearchStore ID (the `file_search_store` segment of the resource name)","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/file-search/documents#v1beta.fileSearchStores.documents.get","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/fileSearchStores/{name}/documents/{document}"},"summary":"Get Document","description":"Gets information about a specific Document","security":[{"bearerAuth":[]}]},"delete":{"tags":["File Search"],"parameters":[{"name":"document","in":"path","description":"The Document ID (the `documents/{document}` segment value)","required":true,"schema":{"type":"string","example":""}},{"name":"name","in":"path","description":"The FileSearchStore ID (the `file_search_store` segment of the resource name)","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/file-search/documents#v1beta.fileSearchStores.documents.delete","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/fileSearchStores/{name}/documents/{document}"},"summary":"Delete Document","description":"Deletes a Document","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1beta/fileSearchStores/{parent}/documents/{document}/pages":{"get":{"tags":["File Search"],"parameters":[{"name":"document","in":"path","description":"The Document ID (the `documents/{document}` segment value)","required":true,"schema":{"type":"string","example":""}},{"name":"parent","in":"path","description":"The FileSearchStore ID (the `file_search_store` segment of the resource name)","required":true,"schema":{"type":"string","example":""}},{"name":"pageSize","in":"query","description":"Optional. The maximum number of pages to return per page","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"Optional. A page token, received from a previous ListPages call","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/file-search/pages#v1beta.fileSearchStores.documents.pages.list","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/fileSearchStores/{parent}/documents/{document}/pages"},"summary":"List Pages","description":"Lists all pages in a Document","security":[{"bearerAuth":[]}]}},"/v1beta/fileSearchStores/{parent}/documents/{document}/pages/{page}":{"get":{"tags":["File Search"],"parameters":[{"name":"document","in":"path","description":"The Document ID (the `documents/{document}` segment value)","required":true,"schema":{"type":"string","example":""}},{"name":"page","in":"path","description":"The page ID","required":true,"schema":{"type":"string","example":""}},{"name":"parent","in":"path","description":"The FileSearchStore ID (the `file_search_store` segment of the resource name)","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/file-search/pages#v1beta.fileSearchStores.documents.pages.get","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/fileSearchStores/{parent}/documents/{document}/pages/{page}"},"summary":"Get Page","description":"Gets information about a specific page in a Document","security":[{"bearerAuth":[]}]}},"/v1beta/models/{model}/batchEmbedText":{"post":{"tags":["Embeddings"],"parameters":[{"name":"model","in":"path","description":"The name of the embedding model to use. Format: models/{model}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/palm#v1beta.models.batchEmbedText","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/models/{model}:batchEmbedText"},"summary":"Batch Embed Text","description":"Generates multiple embeddings from the model given input text in a synchronous call (PaLM legacy)","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"texts":{"type":"array","description":"Required. The input texts to embed","required":true,"items":{"type":"string"}}}},"example":{"texts":[]}}}}}},"/v1beta/models/{model}/embedText":{"post":{"tags":["Embeddings"],"parameters":[{"name":"model","in":"path","description":"The name of the embedding model to use. Format: models/{model}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/palm#v1beta.models.embedText","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/models/{model}:embedText"},"summary":"Embed Text","description":"Generates an embedding from the model given an input message (PaLM legacy)","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"text":{"type":"string","description":"Required. The input text to embed","required":true}}},"example":{"text":""}}}}}},"/v1beta/models/{model}/generateMessage":{"post":{"tags":["Content Generation"],"parameters":[{"name":"model","in":"path","description":"The name of the model to use. Format: models/{model}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/palm#v1beta.models.generateMessage","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/models/{model}:generateMessage"},"summary":"Generate Message","description":"Generates a response from the model given an input MessagePrompt (PaLM legacy)","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"prompt":{"type":"object","description":"Required. The input message prompt","required":true,"properties":{}}}},"example":{"prompt":{}}}}}}},"/v1beta/models/{model}/generateText":{"post":{"tags":["Content Generation"],"parameters":[{"name":"model","in":"path","description":"The name of the model to use. Format: models/{model}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/palm#v1beta.models.generateText","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/models/{model}:generateText"},"summary":"Generate Text","description":"Generates a response from the model given an input message (PaLM legacy)","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"prompt":{"type":"object","description":"Required. The input text prompt","required":true,"properties":{}}}},"example":{"prompt":{}}}}}}},"/v1beta/models/{model}/countMessageTokens":{"post":{"tags":["Tokens"],"parameters":[{"name":"model","in":"path","description":"The name of the model to use. Format: models/{model}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/palm#v1beta.models.countMessageTokens","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/models/{model}:countMessageTokens"},"summary":"Count Message Tokens","description":"Runs a model's tokenizer on a string and returns the token count (PaLM legacy)","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"prompt":{"type":"object","description":"Required. The message prompt to count tokens for","required":true,"properties":{}}}},"example":{"prompt":{}}}}}}},"/v1beta/models/{model}/countTextTokens":{"post":{"tags":["Tokens"],"parameters":[{"name":"model","in":"path","description":"The name of the model to use. Format: models/{model}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/palm#v1beta.models.countTextTokens","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/models/{model}:countTextTokens"},"summary":"Count Text Tokens","description":"Runs a model's tokenizer on a text and returns the token count (PaLM legacy)","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"prompt":{"type":"object","description":"Required. The text prompt to count tokens for","required":true,"properties":{}}}},"example":{"prompt":{}}}}}}},"/v1beta/models/{model}/predict":{"post":{"tags":["Media"],"parameters":[{"name":"model","in":"path","description":"The name of the model to use. Format: models/{model}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/models#v1beta.models.predict","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/models/{model}:predict"},"summary":"Predict","description":"Performs a prediction request","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"instances":{"type":"array","description":"Required. The input instances for prediction","required":true,"items":{"type":"string"}},"parameters":{"type":"object","description":"Optional. Additional parameters for the prediction","properties":{}}}},"example":{"instances":[],"parameters":{}}}}}}},"/v1beta/models/{model}/predictLongRunning":{"post":{"tags":["Media"],"parameters":[{"name":"model","in":"path","description":"The name of the model to use. Format: models/{model}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/models#v1beta.models.predictLongRunning","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/models/{model}:predictLongRunning"},"summary":"Predict Long Running","description":"Same as Predict but returns an LRO (Long Running Operation)","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"instances":{"type":"array","description":"Required. The input instances for prediction","required":true,"items":{"type":"string"}},"parameters":{"type":"object","description":"Optional. Additional parameters for the prediction","properties":{}}}},"example":{"instances":[],"parameters":{}}}}}}},"/v1beta/fileSearchStores/{name}/operations/{operation}":{"get":{"tags":["File Search"],"parameters":[{"name":"name","in":"path","description":"The FileSearchStore ID (the `file_search_store` segment of the resource name)","required":true,"schema":{"type":"string","example":""}},{"name":"operation","in":"path","description":"The operation ID (the `operations/{operation}` segment value)","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/file-search/file-search-stores#v1beta.fileSearchStores.operations.get","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/fileSearchStores/{name}/operations/{operation}"},"summary":"Get File Search Store Operation","description":"Gets the latest state of a long-running operation","security":[{"bearerAuth":[]}]}},"/v1beta/fileSearchStores/{name}/upload/operations/{operation}":{"get":{"tags":["File Search"],"parameters":[{"name":"name","in":"path","description":"The FileSearchStore ID (the `file_search_store` segment of the resource name)","required":true,"schema":{"type":"string","example":""}},{"name":"operation","in":"path","description":"The operation ID (the `operations/{operation}` segment value)","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/file-search/file-search-stores#v1beta.fileSearchStores.upload.operations.get","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/fileSearchStores/{name}/upload/operations/{operation}"},"summary":"Get File Search Store Upload Operation","description":"Gets the latest state of a long-running upload operation","security":[{"bearerAuth":[]}]}},"/v1beta/interactions":{"post":{"tags":["Interactions"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/interactions-api#creating-an-interaction","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/interactions"},"summary":"Create Interaction","description":"Creates a new interaction","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"agent":{"type":"string","description":"Optional. The agent to use for the interaction"},"agent_config":{"type":"object","description":"Optional. Configuration for agent behavior","properties":{}},"background":{"type":"boolean","description":"Optional. Whether to run the model interaction in the background","enum":[true,false]},"generation_config":{"type":"object","description":"Optional. Configuration options for model generation and output","properties":{}},"input":{"type":"string","description":"Required. The inputs for the interaction (common to both Model and Agent)","required":true},"model":{"type":"string","description":"Optional. The model to use for the interaction"},"previous_interaction_id":{"type":"string","description":"Optional. The ID of the previous interaction, if any"},"response_format":{"type":"object","description":"Optional. Enforces that the generated response is a JSON object that complies with the JSON schema specified in this field","properties":{}},"response_mime_type":{"type":"string","description":"Optional. The mime type of the response. This is required if response_format is set"},"response_modalities":{"type":"array","description":"Optional. Response modalities for the interaction","items":{"type":"string"}},"store":{"type":"boolean","description":"Optional. Input only. Whether to store the response and request for later retrieval","enum":[true,false]},"stream":{"type":"boolean","description":"Optional. Input only. Whether the interaction will be streamed","enum":[true,false]},"system_instruction":{"type":"string","description":"Optional. System instruction for the interaction"},"tools":{"type":"array","description":"Optional. A list of tool declarations the model may call during interaction","items":{"type":"string"}}}},"example":{"agent":"","agent_config":{},"background":"","generation_config":{},"input":"","model":"gemini-3.8-flash|gemini-3.5-flash-lite","previous_interaction_id":"","response_format":{},"response_mime_type":"","response_modalities":[],"store":"","stream":"","system_instruction":"","tools":[]}}}}}},"/v1beta/interactions/{id}":{"get":{"tags":["Interactions"],"parameters":[{"name":"id","in":"path","description":"The unique identifier of the interaction to retrieve","required":true,"schema":{"type":"string","example":""}},{"name":"api_version","in":"query","description":"Optional. Which version of the API to use","schema":{"type":"string","example":""}},{"name":"last_event_id","in":"query","description":"Optional. If set, resumes the interaction stream from the next chunk after the event marked by the event id. Can only be used if stream is true","schema":{"type":"string","example":""}},{"name":"stream","in":"query","description":"Optional. If set to true, the generated content will be streamed incrementally","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/interactions-api#retrieving-an-interaction","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/interactions/{id}"},"summary":"Get Interaction","description":"Retrieves the full details of a single interaction based on its Interaction.id","security":[{"bearerAuth":[]}]},"delete":{"tags":["Interactions"],"parameters":[{"name":"id","in":"path","description":"The unique identifier of the interaction to delete","required":true,"schema":{"type":"string","example":""}},{"name":"api_version","in":"query","description":"Optional. Which version of the API to use","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/interactions-api#deleting-an-interaction","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/interactions/{id}"},"summary":"Delete Interaction","description":"Deletes the interaction by id","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1beta/interactions/{id}/cancel":{"post":{"tags":["Interactions"],"parameters":[{"name":"id","in":"path","description":"The unique identifier of the interaction to cancel","required":true,"schema":{"type":"string","example":""}},{"name":"api_version","in":"query","description":"Optional. Which version of the API to use","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/interactions-api#canceling-an-interaction","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/interactions/{id}/cancel"},"summary":"Cancel Interaction","description":"Cancels an interaction by id. This only applies to background interactions that are still running","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1beta/models/{model}/generateAnswer":{"post":{"tags":["Content Generation"],"parameters":[{"name":"model","in":"path","description":"The name of the model to use. Format: models/{model}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/generate-answer","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/models/{model}:generateAnswer"},"summary":"Generate Answer","description":"Generates a grounded answer from the model given an input GenerateAnswerRequest","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"answerStyle":{"type":"string","description":"Optional. Style for grounded answers (ABSTRACTIVE, EXTRACTIVE, VERBOSE)"},"contents":{"type":"array","description":"Required. The content of the current conversation with the model","required":true,"items":{"type":"string"}},"inlinePassages":{"type":"object","description":"Optional. Passages to use as context for grounded answer generation","properties":{}},"safetySettings":{"type":"array","description":"Optional. Safety settings for blocking unsafe content","items":{"type":"string"}},"semanticRetriever":{"type":"object","description":"Optional. Semantic retriever config for grounded answers","properties":{}}}},"example":{"answerStyle":"","contents":[],"inlinePassages":{},"safetySettings":[],"semanticRetriever":{}}}}}}},"/v1beta/files:register":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/files#v1beta.files.register","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/files:register"},"summary":"Register File","description":"Registers a Google Cloud Storage file with the File Service","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"files":{"type":"array","description":"Required. List of files to register with GCS URIs","required":true,"items":{"type":"string"}}}},"example":{"files":[]}}}}}},"/v1beta/generatedFiles":{"get":{"tags":["Files"],"parameters":[{"name":"pageSize","in":"query","description":"Optional. Max files per page","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"Optional. Page token from previous call","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/files#v1beta.generatedFiles.list","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/generatedFiles"},"summary":"List Generated Files","description":"Lists the generated files owned by the requesting project (e.g. images from Imagen)","security":[{"bearerAuth":[]}]}},"/v1beta/generatedFiles/{name}":{"get":{"tags":["Files"],"parameters":[{"name":"name","in":"path","description":"The operation resource name","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/files#v1beta.generatedFiles.operations.get","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/generatedFiles/{name}"},"summary":"Get Generated File Operation","description":"Gets the latest state of a long-running generated file operation","security":[{"bearerAuth":[]}]}},"/v1beta/corpora":{"post":{"tags":["Semantic Retriever"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/semantic-retrieval#v1beta.corpora.create","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/corpora"},"summary":"Create Corpus","description":"Creates an empty Corpus for Semantic Retriever","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"displayName":{"type":"string","description":"Optional. Display name of the Corpus"}}},"example":{"displayName":""}}}}},"get":{"tags":["Semantic Retriever"],"parameters":[{"name":"pageSize","in":"query","description":"Optional. Max results per page","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"Optional. Page token","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/semantic-retrieval#v1beta.corpora.list","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/corpora"},"summary":"List Corpora","description":"Lists all Corpora owned by the user","security":[{"bearerAuth":[]}]}},"/v1beta/corpora/{name}":{"get":{"tags":["Semantic Retriever"],"parameters":[{"name":"name","in":"path","description":"The name of the Corpus. Format: corpora/{corpus}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/semantic-retrieval#v1beta.corpora.get","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/corpora/{name}"},"summary":"Get Corpus","description":"Gets information about a specific Corpus","security":[{"bearerAuth":[]}]},"delete":{"tags":["Semantic Retriever"],"parameters":[{"name":"name","in":"path","description":"The name of the Corpus. Format: corpora/{corpus}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/semantic-retrieval#v1beta.corpora.delete","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/corpora/{name}"},"summary":"Delete Corpus","description":"Deletes a Corpus and all its contents","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1beta/corpora/operations/{name}":{"get":{"tags":["Semantic Retriever"],"parameters":[{"name":"name","in":"path","description":"The operation resource name","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/semantic-retrieval#v1beta.corpora.operations.get","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/corpora/operations/{name}"},"summary":"Get Corpus Operation","description":"Gets the latest state of a long-running Corpus operation","security":[{"bearerAuth":[]}]}},"/v1beta/models/{model}/operations/{operation}":{"get":{"tags":["Models"],"parameters":[{"name":"model","in":"path","description":"The model ID (the `models/{model}` segment value)","required":true,"schema":{"type":"string","example":""}},{"name":"operation","in":"path","description":"The operation ID (the `operations/{operation}` segment value)","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/models#v1beta.models.operations.get","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/models/{model}/operations/{operation}"},"summary":"Get Model Operation","description":"Gets the latest state of a long-running Model Operationmodel operation","security":[{"bearerAuth":[]}]}},"/v1beta/models/{name}/operations/{operation}":{"get":{"tags":["Models"],"parameters":[{"name":"name","in":"path","description":"The model name. Format: models/{model}","required":true,"schema":{"type":"string","example":""}},{"name":"operation","in":"path","description":"The operation ID","required":true,"schema":{"type":"string","example":""}},{"name":"filter","in":"query","description":"Optional. Filter for operations","schema":{"type":"string","example":""}},{"name":"pageSize","in":"query","description":"Optional. Max results","schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/models#v1beta.models.operations.list","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/models/{name}/operations/{operation}"},"summary":"List Model Operations","description":"Lists operations for a Model Operationsmodel","security":[{"bearerAuth":[]}]}},"/v1beta/tunedModels/{name}/operations/{operation}":{"get":{"tags":["Tuning"],"parameters":[{"name":"name","in":"path","description":"The tuned model name. Format: tunedModels/{tuned_model}","required":true,"schema":{"type":"string","example":""}},{"name":"operation","in":"path","description":"The operation ID","required":true,"schema":{"type":"string","example":""}},{"name":"filter","in":"query","description":"Optional. Filter","schema":{"type":"string","example":""}},{"name":"pageSize","in":"query","description":"Optional. Max results","schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/tuning#v1beta.tunedModels.operations.list","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/tunedModels/{name}/operations/{operation}"},"summary":"List Tuned Model Operations","description":"Lists operations for Tuned Model Operationstuned models","security":[{"bearerAuth":[]}]}},"/v1beta/tunedModels/{model}/generateContent":{"post":{"tags":["Tuning"],"parameters":[{"name":"model","in":"path","description":"The name of the tuned model. Format: tunedModels/{tuned_model}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/tuning#v1beta.tunedModels.generateContent","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/tunedModels/{model}:generateContent"},"summary":"Generate Content (Tuned Model)","description":"Generates a model response using a tuned model","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"contents":{"type":"array","description":"Required. The contents of the current conversation","required":true,"items":{"type":"string"}},"generationConfig":{"type":"object","description":"Optional. Configuration options for model generation","properties":{}},"safetySettings":{"type":"array","description":"Optional. Safety settings for blocking unsafe content","items":{"type":"string"}},"systemInstruction":{"type":"object","description":"Optional. System instruction for the model","properties":{}},"toolConfig":{"type":"object","description":"Optional. Tool configuration","properties":{}},"tools":{"type":"array","description":"Optional. Tools the model may use","items":{"type":"string"}}}},"example":{"contents":[],"generationConfig":{},"safetySettings":[],"systemInstruction":{},"toolConfig":{},"tools":[]}}}}}},"/v1beta/tunedModels/{model}/streamGenerateContent":{"post":{"tags":["Tuning"],"parameters":[{"name":"model","in":"path","description":"The name of the tuned model. Format: tunedModels/{tuned_model}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/tuning#v1beta.tunedModels.streamGenerateContent","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/tunedModels/{model}:streamGenerateContent"},"summary":"Stream Generate Content (Tuned Model)","description":"Generates a streamed response using a tuned model","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"contents":{"type":"array","description":"Required. The contents of the current conversation","required":true,"items":{"type":"string"}},"generationConfig":{"type":"object","description":"Optional. Configuration options for model generation","properties":{}},"safetySettings":{"type":"array","description":"Optional. Safety settings","items":{"type":"string"}},"systemInstruction":{"type":"object","description":"Optional. System instruction","properties":{}},"toolConfig":{"type":"object","description":"Optional. Tool configuration","properties":{}},"tools":{"type":"array","description":"Optional. Tools the model may use","items":{"type":"string"}}}},"example":{"contents":[],"generationConfig":{},"safetySettings":[],"systemInstruction":{},"toolConfig":{},"tools":[]}}}}}},"/v1beta/tunedModels/{model}/batchGenerateContent":{"post":{"tags":["Tuning"],"parameters":[{"name":"model","in":"path","description":"The name of the tuned model. Format: tunedModels/{tuned_model}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/tuning#v1beta.tunedModels.batchGenerateContent","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/tunedModels/{model}:batchGenerateContent"},"summary":"Batch Generate Content (Tuned Model)","description":"Enqueues a batch of GenerateContent requests for a tuned model","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"requests":{"type":"array","description":"Required. The requests to process in batch","required":true,"items":{"type":"string"}}}},"example":{"requests":[]}}}}}},"/v1beta/tunedModels/{model}/asyncBatchEmbedContent":{"post":{"tags":["Tuning"],"parameters":[{"name":"model","in":"path","description":"The name of the tuned model. Format: tunedModels/{tuned_model}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/tuning#v1beta.tunedModels.asyncBatchEmbedContent","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/tunedModels/{model}:asyncBatchEmbedContent"},"summary":"Async Batch Embed Content (Tuned Model)","description":"Enqueues a batch of EmbedContent requests for a tuned model","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"requests":{"type":"array","description":"Required. Embed requests for batch processing","required":true,"items":{"type":"string"}}}},"example":{"requests":[]}}}}}},"/v1beta/auth_tokens":{"post":{"tags":["Auth"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/models#v1beta.authTokens.create","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/auth_tokens"},"summary":"Create Auth Token","description":"Creates an auth token for a given user","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"user_id":{"type":"string","description":"Optional. User ID to associate with the auth token"}}},"example":{"user_id":""}}}}}},"/v1beta/dynamic/{model}/generateContent":{"post":{"tags":["Content Generation"],"parameters":[{"name":"model","in":"path","description":"The name of the model to use","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/generate-content#v1beta.models.generateContent","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/models/{model}:generateContent"},"summary":"Generate Content (Dynamic)","description":"Generates a model response using dynamic model name resolution","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"contents":{"type":"array","description":"Required. The contents of the current conversation","required":true,"items":{"type":"string"}},"generationConfig":{"type":"object","description":"Optional. Configuration options for model generation","properties":{}},"safetySettings":{"type":"array","description":"Optional. Safety settings","items":{"type":"string"}},"systemInstruction":{"type":"object","description":"Optional. System instruction","properties":{}},"toolConfig":{"type":"object","description":"Optional. Tool configuration","properties":{}},"tools":{"type":"array","description":"Optional. Tools the model may use","items":{"type":"string"}}}},"example":{"contents":[],"generationConfig":{},"safetySettings":[],"systemInstruction":{},"toolConfig":{},"tools":[]}}}}}},"/v1beta/dynamic/{model}/streamGenerateContent":{"post":{"tags":["Content Generation"],"parameters":[{"name":"model","in":"path","description":"The name of the model to use","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/generate-content#v1beta.models.streamGenerateContent","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/models/{model}:streamGenerateContent"},"summary":"Stream Generate Content (Dynamic)","description":"Generates a streamed response using dynamic model name resolution","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"contents":{"type":"array","description":"Required. The contents of the current conversation","required":true,"items":{"type":"string"}},"generationConfig":{"type":"object","description":"Optional. Configuration options for model generation","properties":{}},"safetySettings":{"type":"array","description":"Optional. Safety settings","items":{"type":"string"}},"systemInstruction":{"type":"object","description":"Optional. System instruction","properties":{}},"toolConfig":{"type":"object","description":"Optional. Tool configuration","properties":{}},"tools":{"type":"array","description":"Optional. Tools the model may use","items":{"type":"string"}}}},"example":{"contents":[],"generationConfig":{},"safetySettings":[],"systemInstruction":{},"toolConfig":{},"tools":[]}}}}}},"/v1beta/corpora/{parent}/permissions":{"post":{"tags":["Semantic Retriever"],"parameters":[{"name":"parent","in":"path","description":"The corpus name. Format: corpora/{corpus}","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/semantic-retrieval#v1beta.corpora.permissions.create","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/corpora/{parent}/permissions"},"summary":"Create Corpus Permission","description":"Creates a permission on a Corpus","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"emailAddress":{"type":"string","description":"Optional. Email of the grantee"},"granteeType":{"type":"string","description":"Required. The type of grantee (USER, GROUP, EVERYONE)","required":true,"enum":["GRANTEE_TYPE_UNSPECIFIED","USER","GROUP","EVERYONE"]},"role":{"type":"string","description":"Required. The role (READER, WRITER, OWNER)","required":true,"enum":["ROLE_UNSPECIFIED","READER","WRITER","OWNER"]}}},"example":{"emailAddress":"","granteeType":"","role":""}}}}},"get":{"tags":["Semantic Retriever"],"parameters":[{"name":"parent","in":"path","description":"The corpus name. Format: corpora/{corpus}","required":true,"schema":{"type":"string","example":""}},{"name":"pageSize","in":"query","description":"Optional. Max results per page","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"Optional. Page token","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/semantic-retrieval#v1beta.corpora.permissions.list","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/corpora/{parent}/permissions"},"summary":"List Corpus Permissions","description":"Lists permissions on a Corpus","security":[{"bearerAuth":[]}]}},"/v1beta/corpora/{parent}/permissions/{permission}":{"get":{"tags":["Semantic Retriever"],"parameters":[{"name":"parent","in":"path","description":"The corpus name. Format: corpora/{corpus}","required":true,"schema":{"type":"string","example":""}},{"name":"permission","in":"path","description":"The permission ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/semantic-retrieval#v1beta.corpora.permissions.get","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/corpora/{parent}/permissions/{permission}"},"summary":"Get Corpus Permission","description":"Gets a specific permission on a Corpus","security":[{"bearerAuth":[]}]}},"/v1beta/corpora/{name}/permissions/{permission}":{"patch":{"tags":["Semantic Retriever"],"parameters":[{"name":"name","in":"path","description":"The corpus name. Format: corpora/{corpus}","required":true,"schema":{"type":"string","example":""}},{"name":"permission","in":"path","description":"The permission ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/semantic-retrieval#v1beta.corpora.permissions.patch","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/corpora/{name}/permissions/{permission}"},"summary":"Patch Corpus Permission","description":"Updates a permission on a Corpus","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"role":{"type":"string","description":"Required. The role (READER, WRITER, OWNER)","required":true,"enum":["ROLE_UNSPECIFIED","READER","WRITER","OWNER"]}}},"example":{"role":""}}}}},"delete":{"tags":["Semantic Retriever"],"parameters":[{"name":"name","in":"path","description":"The corpus name. Format: corpora/{corpus}","required":true,"schema":{"type":"string","example":""}},{"name":"permission","in":"path","description":"The permission ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/semantic-retrieval#v1beta.corpora.permissions.delete","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/corpora/{name}/permissions/{permission}"},"summary":"Delete Corpus Permission","description":"Deletes a permission on a Corpus","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1beta/environments":{"post":{"tags":["Environments"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/environments#CreateEnvironment","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/environments"},"summary":"Create Environment","description":"Creates a persistent execution environment for managed agents","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"from_environment":{"type":"string","description":"Optional. Fork from an existing environment. Format: environments/{environment_id}. When set, sources and network must be empty"},"network":{"type":"object","description":"Optional. Egress network config: an object with an allowlist of EgressRules (credential, domain wildcards, header transforms), or the string 'disabled' to block all egress"},"sources":{"type":"array","description":"Optional. Sources mounted into the environment. Each source has a type: gcs, inline, repository (github://, gcs://) or skill_registry","items":{"type":"string"}}}},"example":{"from_environment":"","network":{},"sources":[]}}}}},"get":{"tags":["Environments"],"parameters":[{"name":"pageSize","in":"query","description":"Optional. Maximum number of environments to return per page. Default 50, maximum 1000","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"Optional. A page token, received from a previous ListEnvironments call","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/environments#ListEnvironments","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/environments"},"summary":"List Environments","description":"Lists environments","security":[{"bearerAuth":[]}]}},"/v1beta/environments/{id}":{"get":{"tags":["Environments"],"parameters":[{"name":"id","in":"path","description":"Required. The identifier of the environment to retrieve","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/environments#GetEnvironment","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/environments/{id}"},"summary":"Get Environment","description":"Gets an environment by ID (status, size, file count, sources, network)","security":[{"bearerAuth":[]}]},"delete":{"tags":["Environments"],"parameters":[{"name":"id","in":"path","description":"Required. The identifier of the environment to delete","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/environments#DeleteEnvironment","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/environments/{id}"},"summary":"Delete Environment","description":"Deletes an environment","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1beta/environments/{environment}/files/{path}":{"get":{"tags":["Environments"],"parameters":[{"name":"environment","in":"path","description":"Required. Environment resource ID","required":true,"schema":{"type":"string","example":""}},{"name":"path","in":"path","description":"Required. File or directory path within the environment, e.g. workspace/src/main.py","required":true,"schema":{"type":"string","example":""}},{"name":"recursive","in":"query","description":"Optional. If true and the path is a directory, recursively lists all files","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"pageSize","in":"query","description":"Optional. Maximum number of entries to return per page (directory listing)","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"Optional. Pagination token for directory listing","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/environments#GetEnvironmentFiles","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/environments/{environment}/files/{path}"},"summary":"Get Environment Files","description":"Retrieves file metadata or directory contents from an environment's snapshot. Use alt=media to download file content","security":[{"bearerAuth":[]}]}},"/upload/v1beta/environments/{environment}/files/{path}":{"put":{"tags":["Environments"],"parameters":[{"name":"environment","in":"path","description":"Required. Environment resource ID","required":true,"schema":{"type":"string","example":""}},{"name":"path","in":"path","description":"Required. Destination file path within the environment","required":true,"schema":{"type":"string","example":""}},{"name":"extract","in":"query","description":"Optional. If true, treats the uploaded file as a tar/tar.gz archive and unpacks it into the destination path","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"overwrite","in":"query","description":"Optional. Whether to overwrite the destination file if it already exists","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/environments#StartEnvironmentFileUpload","api_endpoint":"https://generativelanguage.googleapis.com/upload/v1beta/environments/{environment}/files/{path}"},"summary":"Start Environment File Upload","description":"Starts a resumable upload session for a file in an environment workspace; upload bytes to the URL returned in the X-Goog-Upload-URL response header","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1beta/voices":{"post":{"tags":["Voices"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/voices#CreateVoice","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/voices"},"summary":"Create Voice","description":"Creates a custom voice from a natural-language prompt (prompted) or reference audio with consent (replicated)","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"store":{"type":"boolean","description":"Optional. If true, persists the voice server-side and returns voice.id; required true when voice.type is 'prompted'. Default false returns a client-side voice.key","enum":[true,false]},"voice.type":{"type":"string","description":"Required. Voice type: 'replicated' or 'prompted' ('prebuilt' cannot be created)","required":true},"voice.prompted.input":{"type":"string","description":"Required for prompted voices. The natural-language prompt describing the desired voice"},"voice.prompted.region_code":{"type":"string","description":"Optional. ISO 3166-1 alpha-2 or UN M.49 region code"},"voice.display_name":{"type":"string","description":"Optional. User-supplied display name for stored voices"},"voice.model":{"type":"string","description":"Optional. The model used to design or replicate the voice; defaults to the latest supported voice design model"},"voice.language_code":{"type":"string","description":"Optional. BCP-47 language tag, e.g. en-US"},"voice.gender":{"type":"string","description":"Optional. Voice gender descriptor"},"voice.pitch":{"type":"string","description":"Optional. Voice pitch: low, medium or high"},"voice.description":{"type":"string","description":"Optional. Natural-language description of the voice"}}},"example":{"store":"","voice.type":"","voice.prompted.input":"","voice.prompted.region_code":"","voice.display_name":"","voice.model":"gemini-3.8-flash-tts|gemini-3.8-flash-lite-tts","voice.language_code":"","voice.gender":"","voice.pitch":"","voice.description":""}}}}},"get":{"tags":["Voices"],"parameters":[{"name":"type","in":"query","description":"Optional. Filter by voice type: prebuilt, replicated or prompted (repeatable)","schema":{"type":"string","example":""}},{"name":"language_code","in":"query","description":"Optional. Filter by BCP-47 language tags, e.g. en-US (repeatable)","schema":{"type":"string","example":""}},{"name":"gender","in":"query","description":"Optional. Filter by gender (repeatable)","schema":{"type":"string","example":""}},{"name":"pitch","in":"query","description":"Optional. Filter by pitch: low, medium, high (repeatable)","schema":{"type":"string","example":""}},{"name":"search","in":"query","description":"Optional. Case-insensitive substring match on display_name and description, max 2048 bytes","schema":{"type":"string","example":""}},{"name":"pageSize","in":"query","description":"Optional. Maximum number of voices to return. Default 50, maximum 1000","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"Optional. Page token from a previous ListVoices call; filter params must match the original call","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/voices#ListVoices","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/voices"},"summary":"List Voices","description":"Lists the caller's stored custom voices first (newest first), then prebuilt catalog voices","security":[{"bearerAuth":[]}]}},"/v1beta/voices/{voicesId}":{"get":{"tags":["Voices"],"parameters":[{"name":"voicesId","in":"path","description":"Required. Voice resource name, e.g. voices/voice_abc123def456","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/voices#GetVoice","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/voices/{voicesId}"},"summary":"Get Voice","description":"Retrieves a stored custom voice by resource name. Prebuilt catalog voices are not retrievable this way — use List Voices","security":[{"bearerAuth":[]}]},"delete":{"tags":["Voices"],"parameters":[{"name":"voicesId","in":"path","description":"Required. Voice resource name, e.g. voices/voice_abc123def456","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/voices#DeleteVoice","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/voices/{voicesId}"},"summary":"Delete Voice","description":"Deletes a stored custom voice. Prebuilt catalog voices cannot be deleted","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1beta/credentials":{"post":{"tags":["Credentials"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/credentials#CreateCredential","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/credentials"},"summary":"Create Credential","description":"Creates a server-managed credential (stored in Secret Manager) for authenticating tool calls and MCP servers. Provide exactly one config","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"http_bearer_config":{"type":"object","description":"HTTP Bearer token credential: token (required, write-only), header_name (default 'Authorization'), prefix (default 'Bearer')"},"oauth2_config":{"type":"object","description":"OAuth2 credential: client_id, client_secret, refresh_token, token_url (required, secrets are write-only), scopes (optional array)"},"environment_variable_config":{"type":"object","description":"Environment-variable credential: value (required, write-only), injection_location (header, query and/or body), trusted_domains (optional array)"}}},"example":{"http_bearer_config":{},"oauth2_config":{},"environment_variable_config":{}}}}}},"get":{"tags":["Credentials"],"parameters":[{"name":"pageSize","in":"query","description":"Optional. Maximum number of credentials to return","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"Optional. Page token from a previous ListCredentials call","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/credentials#ListCredentials","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/credentials"},"summary":"List Credentials","description":"Lists credentials (metadata only: id, type, status, create/update times — values are never returned)","security":[{"bearerAuth":[]}]}},"/v1beta/credentials/{id}":{"get":{"tags":["Credentials"],"parameters":[{"name":"id","in":"path","description":"Required. The identifier of the credential to retrieve","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/credentials#GetCredential","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/credentials/{id}"},"summary":"Get Credential","description":"Gets a credential by ID (metadata only)","security":[{"bearerAuth":[]}]},"patch":{"tags":["Credentials"],"parameters":[{"name":"id","in":"path","description":"Required. The identifier of the credential to update","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/credentials#UpdateCredential","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/credentials/{id}"},"summary":"Update Credential","description":"Updates a credential. Provide the config matching the credential type; all fields optional except type","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"http_bearer_config":{"type":"object","description":"HTTP Bearer token credential: token (required, write-only), header_name (default 'Authorization'), prefix (default 'Bearer')"},"oauth2_config":{"type":"object","description":"OAuth2 credential: client_id, client_secret, refresh_token, token_url (required, secrets are write-only), scopes (optional array)"},"environment_variable_config":{"type":"object","description":"Environment-variable credential: value (required, write-only), injection_location (header, query and/or body), trusted_domains (optional array)"}}},"example":{"http_bearer_config":{},"oauth2_config":{},"environment_variable_config":{}}}}}},"delete":{"tags":["Credentials"],"parameters":[{"name":"id","in":"path","description":"Required. The identifier of the credential to delete","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/credentials#DeleteCredential","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/credentials/{id}"},"summary":"Delete Credential","description":"Deletes a credential","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1beta/agents":{"post":{"tags":["Agents"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/agents#CreateAgent","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/agents"},"summary":"Create Agent","description":"Creates a managed agent that reasons, writes code, manages files and browses the web","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"id":{"type":"string","description":"Optional. Unique identifier for the agent"},"description":{"type":"string","description":"Optional. Human-readable description for developers"},"system_instruction":{"type":"string","description":"Optional. System instruction for the agent"},"agent_config.model":{"type":"string","description":"Optional. Model used for agent reasoning"},"agent_config.max_total_tokens":{"type":"string","description":"Optional. Max total tokens for the agent run"},"agent_config.base_agent":{"type":"string","description":"Optional. The base agent to extend, e.g. antigravity-preview-09-2026"},"agent_config.base_environment":{"type":"string","description":"Optional. Base environment: a config object, an environment ID, or 'remote'"},"tools":{"type":"array","description":"Optional. Tools available to the agent: code_execution, function declarations, google_search, url_context, or mcp_server entries","items":{"type":"string"}}}},"example":{"id":"","description":"","system_instruction":"","agent_config.model":"gemini-3.8-flash|gemini-3.5-flash-lite","agent_config.max_total_tokens":"","agent_config.base_agent":"antigravity-preview-09-2026","agent_config.base_environment":"","tools":[]}}}}},"get":{"tags":["Agents"],"parameters":[{"name":"pageSize","in":"query","description":"Optional. Maximum number of agents to return","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"Optional. Page token from a previous ListAgents call","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/agents#ListAgents","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/agents"},"summary":"List Agents","description":"Lists agents","security":[{"bearerAuth":[]}]}},"/v1beta/agents/{agentsId}":{"get":{"tags":["Agents"],"parameters":[{"name":"agentsId","in":"path","description":"Required. The name of the agent to retrieve","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/agents#GetAgent","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/agents/{agentsId}"},"summary":"Get Agent","description":"Gets an agent by name","security":[{"bearerAuth":[]}]},"delete":{"tags":["Agents"],"parameters":[{"name":"agentsId","in":"path","description":"Required. The name of the agent to delete","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/agents#DeleteAgent","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/agents/{agentsId}"},"summary":"Delete Agent","description":"Deletes an agent","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1beta/webhooks":{"post":{"tags":["Webhooks"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/webhooks#CreateWebhook","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/webhooks"},"summary":"Create Webhook","description":"Creates a webhook that delivers events to your URI; the response includes new_signing_secret (only populated on create)","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"Optional. The user-provided name of the webhook"},"subscribed_events":{"type":"array","description":"Required. Events to subscribe to: batch.succeeded, batch.expired, batch.failed, interaction.requires_action, interaction.completed, interaction.failed, video.generated","required":true,"items":{"type":"string"}},"uri":{"type":"string","description":"Required. The URI to which webhook events will be sent","required":true}}},"example":{"name":"","subscribed_events":[],"uri":""}}}}},"get":{"tags":["Webhooks"],"parameters":[{"name":"pageSize","in":"query","description":"Optional. Maximum number of webhooks to return. Default 50, maximum 1000","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"Optional. Page token from a previous ListWebhooks call","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/webhooks#ListWebhooks","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/webhooks"},"summary":"List Webhooks","description":"Lists webhooks","security":[{"bearerAuth":[]}]}},"/v1beta/webhooks/{id}":{"get":{"tags":["Webhooks"],"parameters":[{"name":"id","in":"path","description":"Required. The identifier of the webhook to retrieve","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/webhooks#GetWebhook","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/webhooks/{id}"},"summary":"Get Webhook","description":"Gets a webhook by ID","security":[{"bearerAuth":[]}]},"patch":{"tags":["Webhooks"],"parameters":[{"name":"id","in":"path","description":"Required. The identifier of the webhook to update","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/webhooks#UpdateWebhook","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/webhooks/{id}"},"summary":"Update Webhook","description":"Updates a webhook (name, state, subscribed events or delivery URI)","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"Optional. The user-provided name of the webhook"},"state":{"type":"string","description":"Optional. Webhook state: enabled, disabled, or disabled_due_to_failed_deliveries"},"subscribed_events":{"type":"array","description":"Optional. Events to subscribe to: batch.succeeded, batch.expired, batch.failed, interaction.requires_action, interaction.completed, interaction.failed, video.generated","items":{"type":"string"}},"uri":{"type":"string","description":"Optional. The URI to which webhook events will be sent"}}},"example":{"name":"","state":"","subscribed_events":[],"uri":""}}}}},"delete":{"tags":["Webhooks"],"parameters":[{"name":"id","in":"path","description":"Required. The identifier of the webhook to delete","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/webhooks#DeleteWebhook","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/webhooks/{id}"},"summary":"Delete Webhook","description":"Deletes a webhook","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1beta/webhooks/{id}:ping":{"post":{"tags":["Webhooks"],"parameters":[{"name":"id","in":"path","description":"Required. The identifier of the webhook to ping","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/webhooks#PingWebhook","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/webhooks/{id}:ping"},"summary":"Ping Webhook","description":"Sends a test delivery to the webhook URI","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1beta/webhooks/{id}:rotateSigningSecret":{"post":{"tags":["Webhooks"],"parameters":[{"name":"id","in":"path","description":"Required. The identifier of the webhook","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/webhooks#RotateSigningSecret","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/webhooks/{id}:rotateSigningSecret"},"summary":"Rotate Webhook Signing Secret","description":"Rotates the webhook signing secret; response contains the newly generated secret","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"revocation_behavior":{"type":"string","description":"Optional. revoke_previous_secrets_after_h24 (default, safest for migrations) or revoke_previous_secrets_immediately (can interrupt ongoing notifications)"}}},"example":{"revocation_behavior":""}}}}}},"/v1beta/triggers":{"post":{"tags":["Triggers"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/triggers#CreateTrigger","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/triggers"},"summary":"Create Trigger","description":"Creates a trigger that executes an interaction on a cron schedule","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"display_name":{"type":"string","description":"Optional. The display name of the trigger"},"schedule":{"type":"string","description":"Required. The cron schedule on which the trigger should run. Standard cron format","required":true},"time_zone":{"type":"string","description":"Required. Time zone in which the schedule should be interpreted, e.g. America/New_York","required":true},"interaction.input":{"type":"string","description":"The input for the interaction (message content)"},"interaction.agent":{"type":"string","description":"Optional. The agent to use for the interaction"},"interaction.environment":{"type":"string","description":"Optional. The environment to run the interaction in"},"interaction.tools":{"type":"array","description":"Optional. Tool declarations the model may call","items":{"type":"string"}},"environment_id":{"type":"string","description":"Optional. The environment ID for the trigger execution"},"execution_timeout_seconds":{"type":"number","description":"Optional. Timeout for the triggered interaction"},"max_consecutive_failures":{"type":"number","description":"Optional. Max consecutive failures before the trigger is automatically paused (status becomes ERROR)"}}},"example":{"display_name":"","schedule":"","time_zone":"","interaction.input":"","interaction.agent":"","interaction.environment":"","interaction.tools":[],"environment_id":"","execution_timeout_seconds":"","max_consecutive_failures":""}}}}},"get":{"tags":["Triggers"],"parameters":[{"name":"filter","in":"query","description":"Optional. Filter expression, e.g. by status","schema":{"type":"string","example":""}},{"name":"pageSize","in":"query","description":"Optional. Maximum number of triggers to return","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"Optional. Page token from a previous ListTriggers call","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/triggers#ListTriggers","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/triggers"},"summary":"List Triggers","description":"Lists triggers","security":[{"bearerAuth":[]}]}},"/v1beta/triggers/{id}":{"get":{"tags":["Triggers"],"parameters":[{"name":"id","in":"path","description":"Required. Resource name of the trigger","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/triggers#GetTrigger","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/triggers/{id}"},"summary":"Get Trigger","description":"Gets a trigger by resource name","security":[{"bearerAuth":[]}]},"patch":{"tags":["Triggers"],"parameters":[{"name":"id","in":"path","description":"Required. Resource name of the trigger","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/triggers#UpdateTrigger","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/triggers/{id}"},"summary":"Update Trigger","description":"Updates a trigger (display name) or pauses/resumes it (status)","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"display_name":{"type":"string","description":"Optional. The display name of the trigger"},"status":{"type":"string","description":"Optional. Set to 'paused' or 'active' to pause/resume the trigger"}}},"example":{"display_name":"","status":""}}}}},"delete":{"tags":["Triggers"],"parameters":[{"name":"id","in":"path","description":"Required. Resource name of the trigger","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/triggers#DeleteTrigger","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/triggers/{id}"},"summary":"Delete Trigger","description":"Deletes a trigger","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1beta/triggers/{trigger_id}/executions":{"post":{"tags":["Triggers"],"parameters":[{"name":"trigger_id","in":"path","description":"Required. Resource name of the trigger","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/triggers#RunTrigger","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/triggers/{trigger_id}/executions"},"summary":"Run Trigger","description":"Runs a trigger immediately, outside its schedule; returns a TriggerExecution","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Triggers"],"parameters":[{"name":"trigger_id","in":"path","description":"Required. Resource name of the trigger","required":true,"schema":{"type":"string","example":""}},{"name":"pageSize","in":"query","description":"Optional. Maximum number of executions to return","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"Optional. Page token from a previous call","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://ai.google.dev/api/triggers#ListTriggerExecutions","api_endpoint":"https://generativelanguage.googleapis.com/v1beta/triggers/{trigger_id}/executions"},"summary":"List Trigger Executions","description":"Lists executions of a trigger","security":[{"bearerAuth":[]}]}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"security":[{"bearerAuth":[]}]}