For Agents
Provision, scale, fork, suspend, and resume managed PostgreSQL clusters on Crunchy Bridge, plus manage account and team membership.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Crunchy Bridge 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 Crunchy Bridge API.
Provision a new managed PostgreSQL cluster on Crunchy Bridge
Update cluster size, plan, or configuration via PATCH on the cluster resource
Fork an existing cluster to create a point-in-time copy for testing or analytics
GET STARTED
Use for: Provision a new PostgreSQL cluster on Crunchy Bridge, Suspend my idle staging cluster overnight to save cost, Fork the production cluster for a one-off analytics workload, Enable high availability on cluster cl_abc123
Not supported: Does not handle in-database SQL execution, query monitoring, or schema migration — use for cluster lifecycle, account, and team management only.
Jentic publishes the only available OpenAPI specification for Crunchy Bridge API, keeping it validated and agent-ready. Crunchy Bridge is a managed PostgreSQL service, and the API exposes 23 endpoints for account management, cluster lifecycle, cluster forks, high-availability toggles, suspend and resume, backups, Tailscale connectivity, and team administration. Authentication uses a bearer token issued from the Crunchy Bridge account settings page in the cbkey_ prefix format.
Toggle high availability on a cluster with the enable-ha and disable-ha actions
Suspend, resume, restart, and ping a cluster to control runtime cost and state
Trigger an on-demand backup or connect a cluster to a Tailscale network
Create and manage teams that share access to clusters and accounts
Patterns agents use Crunchy Bridge API for, with concrete tasks.
★ Cost-Aware Cluster Lifecycle
Reduce cloud spend by suspending non-production clusters outside business hours and resuming them on demand. Crunchy Bridge exposes suspend, resume, and ping actions as first-class API verbs so a scheduler or agent can drive the lifecycle without going through the dashboard.
PUT /clusters/{cluster_id}/actions/suspend at 7pm and /clusters/{cluster_id}/actions/resume at 7am for every staging cluster tagged 'office-hours'.
Production Forks for Safe Testing
Create a forked copy of a production cluster before running a risky schema migration or load test. The fork is a point-in-time copy that lets the team validate the change against realistic data without touching the live database.
POST /clusters/{cluster_id}/forks with a target plan and name 'migration-test', then run the migration against the new fork.
On-Demand Backup Before Deploys
Trigger an on-demand backup as part of a CI/CD pipeline immediately before any production deploy, then continue only if the backup completes. Provides a fast rollback target without waiting for the next scheduled backup window.
Call PUT /clusters/{cluster_id}/actions/start-backup, poll GET /clusters/{cluster_id}/status until backup completes, then proceed with deploy.
Team and Access Management
Manage which teams have access to which clusters by creating teams, updating membership, and tearing them down via the teams endpoints. Useful when onboarding contractors or rotating engineering pods between projects.
POST /teams to create a 'data-platform' team, then PATCH /teams/{team_id} to update its members and clusters.
Agent-Driven Database Operations
Allow an AI ops agent to handle routine PostgreSQL chores — provisioning a temporary cluster, suspending it after the work, triggering backups — through Jentic so the cbkey_ token stays in the vault and out of agent context.
Search Jentic for 'provision a postgres cluster', load the create-cluster operation, and execute it with the requested plan and region.
23 endpoints — jentic publishes the only available openapi specification for crunchy bridge api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/clusters
Create a managed PostgreSQL cluster
/clusters
List clusters
/clusters/{cluster_id}
Update a cluster
/clusters/{cluster_id}/forks
Fork an existing cluster
/clusters/{cluster_id}/actions/suspend
Suspend a cluster
/clusters/{cluster_id}/actions/resume
Resume a suspended cluster
/clusters/{cluster_id}/actions/start-backup
Trigger an on-demand backup
/teams
Create a team
/clusters
Create a managed PostgreSQL cluster
/clusters
List clusters
/clusters/{cluster_id}
Update a cluster
/clusters/{cluster_id}/forks
Fork an existing cluster
/clusters/{cluster_id}/actions/suspend
Suspend a cluster
Three things that make agents converge on Jentic-routed access.
Credential isolation
Crunchy Bridge cbkey_ tokens are stored encrypted in the Jentic vault. Agents never see the raw token — Jentic injects it into the Authorization header at execution time.
Intent-based discovery
Agents search Jentic by intent (e.g. 'provision a postgres cluster') and Jentic returns the matching create-cluster or cluster-action operation along with its parameter schema.
Time to first call
Direct integration: 1-2 days to wire bearer auth, cluster lifecycle handling, and polling of /status. Through Jentic: minutes per operation.
Alternatives and complements available in the Jentic catalogue.
Specific to using Crunchy Bridge API through Jentic.
Why is there no official OpenAPI spec for Crunchy Bridge API?
Crunchy Bridge does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Crunchy Bridge API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Crunchy Bridge API use?
The API uses a bearer token in the Authorization header. Tokens are issued from the Crunchy Bridge account settings page in the format cbkey_[your_api_key]. Through Jentic the token is stored encrypted in the vault and never enters the agent prompt.
Can I fork a Crunchy Bridge cluster through the API?
Yes. POST /clusters/{cluster_id}/forks creates a point-in-time copy of an existing cluster on a target plan. The new cluster appears in /clusters once the fork completes.
How do I suspend a Crunchy Bridge cluster to save cost?
Call PUT /clusters/{cluster_id}/actions/suspend. The cluster stops billing for compute while suspended. Resume with PUT /clusters/{cluster_id}/actions/resume when you need it again.
What are the rate limits for the Crunchy Bridge API?
The OpenAPI specification does not document specific numeric rate limits. Watch for HTTP 429 responses on bursty traffic and throttle requests accordingly. Contact Crunchy Bridge support for production quotas.
How do I provision a cluster through Jentic?
Run pip install jentic, search 'provision a postgres cluster', load the create-cluster operation, and execute it with your plan and region. Jentic injects the cbkey_ bearer token automatically.
/clusters/{cluster_id}/actions/resume
Resume a suspended cluster
/clusters/{cluster_id}/actions/start-backup
Trigger an on-demand backup
/teams
Create a team