google · Google AI Docs
Gemini API Webhooks
Explains how to configure and implement webhooks to receive real-time notifications and event-driven updates from the Gemini API.
Derived skill
Files assembled from official documentation
Viewing SKILL.md
Gemini API Webhooks
Explains how to configure and implement webhooks to receive real-time notifications and event-driven updates from the Gemini API.
When To Use
Use when you need to implement an asynchronous notification system to handle API events or status updates without constant polling.
Reference Files
| File | Contains | Use For |
|---|---|---|
SKILL.md | Entry point: scope, routing table, and workflow. | Start here. |
docs/gemini-api-webhooks-workflow-guide.md | A guide explaining how the Gemini API uses webhooks to push real-time notifications for asynchronous and long-running operations to a server. | Questions about a guide explaining how the Gemini API uses webhooks to push real-time notifications for asynchronous and long-running... |
examples/gemini-api-webhooks-gemini-api-python-webhook-creation.text | A Python code snippet demonstrating how to create a Gemini API webhook with subscribed events and a callback URI using the genai client. | Exact payloads, commands, or snippets shown in A Python code snippet demonstrating how to create a Gemini API webhook with subscribed events and a callback URI usin... |
examples/gemini-api-webhooks-gemini-api-nodejs-webhook-creation.text | A Node.js code example demonstrating how to create a webhook with specific subscribed events and a callback URI using the Google GenAI SDK. | Exact payloads, commands, or snippets shown in A Node.js code example demonstrating how to create a webhook with specific subscribed events and a callback URI using... |
examples/gemini-api-webhooks-curl-registration-request.text | A curl command demonstrating how to register a new webhook endpoint with the Gemini API using a POST request. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to register a new webhook endpoint with the Gemini API using a POST request. |
examples/gemini-api-webhooks-gemini-api-python-webhook-get.text | A Python code snippet demonstrating how to retrieve webhook details using the Google GenAI client. | Exact payloads, commands, or snippets shown in A Python code snippet demonstrating how to retrieve webhook details using the Google GenAI client. |
examples/gemini-api-webhooks-gemini-api-nodejs-webhooks-get.text | A Node.js code example demonstrating how to retrieve webhook details using the GoogleGenAI client. | Exact payloads, commands, or snippets shown in A Node.js code example demonstrating how to retrieve webhook details using the GoogleGenAI client. |
examples/gemini-api-webhooks-list-webhooks-curl.text | A curl command used to list configured webhooks for the Gemini API using an API key. | Exact payloads, commands, or snippets shown in A curl command used to list configured webhooks for the Gemini API using an API key. |
examples/gemini-api-webhooks-gemini-api-python-list-webhooks.text | A Python code snippet demonstrating how to use the Gemini API client to list configured webhooks. | Exact payloads, commands, or snippets shown in A Python code snippet demonstrating how to use the Gemini API client to list configured webhooks. |
examples/gemini-api-webhooks-gemini-api-list-webhooks-nodejs.text | A Node.js code example demonstrating how to use the GoogleGenAI client to list existing webhooks. | Exact payloads, commands, or snippets shown in A Node.js code example demonstrating how to use the GoogleGenAI client to list existing webhooks. |
examples/gemini-api-webhooks-list-curl.text | A curl command to list configured webhooks for the Gemini API using an API key. | Exact payloads, commands, or snippets shown in A curl command to list configured webhooks for the Gemini API using an API key. |
examples/gemini-api-webhooks-gemini-api-python-webhook-update.text | A Python code snippet demonstrating how to update a Gemini API webhook subscription using the genai client. | Exact payloads, commands, or snippets shown in A Python code snippet demonstrating how to update a Gemini API webhook subscription using the genai client. |
examples/gemini-api-webhooks-gemini-api-nodejs-webhook-update.text | A Node.js code example demonstrating how to update a Gemini API webhook subscription using the GoogleGenAI client. | Exact payloads, commands, or snippets shown in A Node.js code example demonstrating how to update a Gemini API webhook subscription using the GoogleGenAI client. |
examples/gemini-api-webhooks-patch-subscription-curl.text | A curl command demonstrating how to patch webhook subscriptions for batch job events using the Gemini API. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to patch webhook subscriptions for batch job events using the Gemini API. |
examples/gemini-api-webhooks-gemini-api-python-webhook-deletion.text | A Python code snippet demonstrating how to use the Gemini API client to delete a specific webhook by its ID. | Exact payloads, commands, or snippets shown in A Python code snippet demonstrating how to use the Gemini API client to delete a specific webhook by its ID. |
examples/gemini-api-webhooks-gemini-api-nodejs-delete-webhook.text | A Node.js code snippet demonstrating how to use the GoogleGenAI client to delete a configured webhook. | Exact payloads, commands, or snippets shown in A Node.js code snippet demonstrating how to use the GoogleGenAI client to delete a configured webhook. |
examples/gemini-api-webhooks-delete-curl-request.text | A curl command demonstrating how to delete a webhook using the Gemini API. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to delete a webhook using the Gemini API. |
examples/gemini-api-webhooks-gemini-api-python-rotate-signing-secret.text | A Python code snippet demonstrating how to use the Gemini API client to rotate a webhook signing secret. | Exact payloads, commands, or snippets shown in A Python code snippet demonstrating how to use the Gemini API client to rotate a webhook signing secret. |
examples/gemini-api-webhooks-nodejs-rotate-signing-secret.text | A Node.js code example demonstrating how to use the GoogleGenAI client to rotate a webhook signing secret with a specific revocation behavior. | Exact payloads, commands, or snippets shown in A Node.js code example demonstrating how to use the GoogleGenAI client to rotate a webhook signing secret with a spec... |
examples/gemini-api-webhooks-rotate-secret-curl.text | A curl command demonstrating how to rotate a webhook secret using the Gemini API. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to rotate a webhook secret using the Gemini API. |
examples/gemini-api-webhooks-flask-verification.text | A Python Flask implementation demonstrating how to verify Gemini API webhook signatures using the standardwebhooks library. | Exact payloads, commands, or snippets shown in A Python Flask implementation demonstrating how to verify Gemini API webhook signatures using the standardwebhooks li... |
examples/gemini-api-webhooks-nodejs-express-implementation.text | A Node.js Express implementation demonstrating how to receive and verify Gemini API webhook callbacks using the standardwebhooks library. | Exact payloads, commands, or snippets shown in A Node.js Express implementation demonstrating how to receive and verify Gemini API webhook callbacks using the stand... |
examples/gemini-api-webhooks-gemini-api-python-batch-job-webhook-config.text | A Python code snippet demonstrating how to configure a webhook URI and user metadata when creating a batch job using the Gemini API. | Exact payloads, commands, or snippets shown in A Python code snippet demonstrating how to configure a webhook URI and user metadata when creating a batch job using... |
examples/gemini-api-webhooks-gemini-api-nodejs-batch-create-webhook-config.text | A Node.js code snippet demonstrating how to create a batch job with a webhook configuration using the GoogleGenAI client. | Exact payloads, commands, or snippets shown in A Node.js code snippet demonstrating how to create a batch job with a webhook configuration using the GoogleGenAI cli... |
examples/gemini-api-webhooks-curl-batchcreate-request.text | A curl command demonstrating a POST request to the batchCreate endpoint with webhook configuration for the Gemini API. | Exact payloads, commands, or snippets shown in A curl command demonstrating a POST request to the batchCreate endpoint with webhook configuration for the Gemini API. |
examples/gemini-api-webhooks-python-flask-jwt-verification.text | A Python Flask implementation demonstrating how to verify Gemini API webhook signatures using Google's public JWKS endpoint. | Exact payloads, commands, or snippets shown in A Python Flask implementation demonstrating how to verify Gemini API webhook signatures using Google's public JWKS en... |
examples/gemini-api-webhooks-nodejs-express-server-implementation.text | A Node.js Express server implementation demonstrating how to receive and verify Gemini API webhook notifications using JWKS. | Exact payloads, commands, or snippets shown in A Node.js Express server implementation demonstrating how to receive and verify Gemini API webhook notifications usin... |
examples/gemini-api-webhooks-batch-succeeded-payload.text | A text representation of a JSON payload sent by a Gemini API webhook when a batch job successfully completes. | Exact payloads, commands, or snippets shown in A text representation of a JSON payload sent by a Gemini API webhook when a batch job successfully completes. |
What This Skill Covers
- Webhooks allow the Gemini API to push real-time notifications to your server when asynchronous or Long-Running Operations (LROs) complete. This replaces the...
- Main sections:
How it works,Static webhooks,Create a webhook,Python,JavaScript.
Workflow
- Open the most relevant file under
docs/for the exact documented workflow and wording. - Open
schemas/files for exact structured contracts. - Open
examples/files for concrete requests, commands, snippets, and manifests. - Do not add behavior or configuration that is not present in the attached source files.
Canonical source: https://ai.google.dev/gemini-api/docs/webhooks