For Agents
Track and clean up long-running Firebase Hosting operations such as custom domain provisioning so an agent can manage Hosting deploys without manual console work.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Firebase Hosting API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Firebase Hosting API.
List long-running Firebase Hosting operations under a site or custom domain
Cancel an in-flight Firebase Hosting custom domain operation
Delete a completed Firebase Hosting operation resource
GET STARTED
Use for: List Firebase Hosting long-running operations under a site, Cancel a stuck custom domain provisioning operation, Find all completed Firebase Hosting operations for a custom domain, Check whether a Hosting operation has finished
Not supported: Does not deploy releases, finalise versions, or manage channels directly in this v1 surface — use for tracking, cancelling, and pruning Firebase Hosting long-running operations only.
The Firebase Hosting REST API enables programmatic management of long-running operations behind Firebase Hosting sites and channels, including custom domain provisioning workflows. The v1 surface exposes operations to list, cancel, and delete the long-running operation resources spawned by deploys, channel creation, and custom domain setup. Use it to monitor and tidy up asynchronous Hosting jobs from automation pipelines.
Monitor the state of asynchronous custom domain provisioning jobs
Reconcile Hosting operation history during pipeline troubleshooting
Patterns agents use Firebase Hosting API for, with concrete tasks.
★ Custom Domain Provisioning Monitoring
Provisioning a custom domain on Firebase Hosting kicks off a long-running operation. The Hosting v1 API lets pipelines list and inspect those operations under projects/{project}/sites/{site}/customDomains/{domain}/operations to confirm SSL issuance and DNS verification have completed before flipping traffic. Polling integration with a deploy pipeline takes a few hours.
Call GET /v1/{+name} on a Hosting custom-domain operation resource and check that done is true and error is unset before proceeding to flip DNS to the Hosting site.
Cancelling Stuck Custom Domain Setup
When a Firebase Hosting custom domain operation hangs because of DNS misconfiguration or repeated SSL issuance failures, the API supports cancelling the operation via POST /v1/{+name}:cancel. This frees up the underlying resource so engineers can retry the operation cleanly with the corrected DNS records.
Call POST /v1/{+name}:cancel on the in-flight custom domain operation and verify via GET /v1/{+name} that the operation now reports done with a cancellation status.
Operation History Cleanup
Old Firebase Hosting operation resources accumulate as deploys and domain changes happen over time. DELETE /v1/{+name} removes a completed operation record to keep the operations list focused on recent activity. This is a low-frequency hygiene task suited to weekly maintenance runs.
Call DELETE /v1/{+name} on an operation that has been done=true for over 30 days to prune the operation history under a customDomains resource.
Agent-Driven Hosting Pipeline Monitoring via Jentic
An AI agent connected through Jentic can watch Firebase Hosting deploys and custom domain operations on behalf of a release engineer, surfacing failures and cancelling stuck operations as needed. Jentic exposes the 3 Hosting v1 operation endpoints, the agent strings them together, and OAuth credentials stay sealed inside the Jentic vault.
Through Jentic, search for monitor firebase hosting operations, load the operations.list endpoint, and execute it for projects/PROJECT/sites/SITE/customDomains/DOMAIN to surface any operations whose done flag is still false after one hour.
3 endpoints — the firebase hosting rest api enables programmatic management of long-running operations behind firebase hosting sites and channels, including custom domain provisioning workflows.
METHOD
PATH
DESCRIPTION
/v1/{+name}
List Firebase Hosting operations under a resource
/v1/{+name}:cancel
Cancel a Firebase Hosting long-running operation
/v1/{+name}
Delete a Firebase Hosting operation resource
/v1/{+name}
List Firebase Hosting operations under a resource
/v1/{+name}:cancel
Cancel a Firebase Hosting long-running operation
/v1/{+name}
Delete a Firebase Hosting operation resource
Three things that make agents converge on Jentic-routed access.
Credential isolation
Google OAuth 2.0 service-account credentials are stored in the Jentic vault. Agents receive a scoped access token per call, so the underlying private key never enters the agent's prompt or tool-call payloads.
Intent-based discovery
Agents search Jentic with intents like monitor firebase hosting operations and Jentic returns the operations.list, operations.cancel, and operations.delete endpoints with their resource-name parameters resolved from the spec.
Time to first call
Direct integration with the Hosting operations API: 1-2 days for OAuth and pipeline polling. Through Jentic: under 30 minutes.
Alternatives and complements available in the Jentic catalogue.
Specific to using Firebase Hosting API through Jentic.
What authentication does the Firebase Hosting API use?
The API uses Google OAuth 2.0 with the firebase or cloud-platform scope. Through Jentic the OAuth credentials are stored in the encrypted vault and a scoped access token is supplied per request without exposing the underlying service-account key.
Can I deploy a new release with the v1 Firebase Hosting API endpoints exposed here?
No. The v1 endpoints in this spec cover long-running operation management only — list, cancel, and delete. Release deployment, version finalisation, and channel creation are handled in the broader Firebase Hosting REST surface and the firebase CLI; this spec is the operations-monitoring surface.
What are the rate limits for the Firebase Hosting API?
Google enforces standard googleapis.com per-project read and write quotas. Operation listing is a low-cost read endpoint, and pipelines that poll frequently should respect the per-minute project quota with backoff between polls.
How do I monitor a Firebase Hosting custom domain operation through Jentic?
Run pip install jentic, search for monitor firebase hosting operations, load the operations.list endpoint, and execute it for projects/PROJECT/sites/SITE/customDomains/DOMAIN/operations. Sign up at https://app.jentic.com/sign-up.
Does the Firebase Hosting API support cancelling stuck custom domain operations?
Yes. POST /v1/{+name}:cancel on the operation resource cancels the in-flight job. After cancellation the operation reports done=true with a cancellation status, allowing pipelines to retry custom domain setup with corrected DNS or verification records.
Is the Firebase Hosting API free?
Firebase Hosting is included with Firebase under standard free-tier limits. Bandwidth and storage above those limits are billed under the Hosting price list; the operations endpoints themselves do not incur additional charges.