Neon Tech Neon API

Name: Neon API
Brand: Neon API
Availability: InStock

✓ Official Vendor SpecStorageDatabasebearer138 EndpointsREST

For Agents

Manage Neon Postgres projects, branches, compute endpoints, roles, and API keys via the neon.tech control plane.

Install Jentic One Beta

Connect the Neon API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Neon 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 | sh

Step 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 instance

Jentic 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.

Capabilities

What an agent can do with Neon API.

Provision and destroy Neon projects with regions and Postgres versions chosen at create time

Create branches off any project for preview environments, restore from a point in time, or fork production data

Spin up compute endpoints (read-write and read replicas) attached to a branch

GET STARTED

Start building with Neon API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Neon API for, with concrete tasks.

★ Per Pull Request Database Branches

Engineering teams script /projects/{project_id}/branches so every pull request gets its own isolated Postgres branch off the production schema and data. The branch is a copy-on-write fork — provisioning takes seconds, the preview environment runs migrations against real data, and the branch is deleted when the PR closes.

Create a branch named pr-1234 off the main branch of project shadowy-snow-12345, then return the connection string for the new compute endpoint.

Read Replica Provisioning

Backend services attach a read-replica compute endpoint to a branch to scale BI and analytics reads without slowing the write path. Replicas spin up in seconds and scale to zero when idle, so the cost matches actual query traffic rather than peak provisioned capacity.

Create a read-replica compute endpoint on the main branch of a Neon project and return its connection string for the BI dashboard.

Restore from Point in Time

Operations engineers respond to a bad migration by calling /projects/{project_id}/restore against a recent timestamp. Neon resolves the request to a fresh branch at that data state, and /projects/{project_id}/operations/{operation_id} reports progress until the branch is ready.

Restore the main branch of a Neon project to its state from 2 hours ago and poll the operation until it reports finished.

AI Agent Integration via Jentic

An AI agent uses Jentic to provision Neon resources during a deploy or test workflow. Jentic exposes /projects, /branches, and /endpoints by intent, the agent supplies project, region, and Postgres version, and the bearer key stays in the Jentic vault rather than the agent context.

Use Jentic to search for create a neon project, load the schema, and create a project named agent-demo in the us-east-2 region.

Key Endpoints

138 endpoints — the neon api on the neon.

METHOD

PATH

DESCRIPTION

GET

/projects

List Neon projects

POST

/projects

Create a new Neon project

GET

/projects/{project_id}

Get a project by id

POST

/projects/{project_id}/restore

Restore a branch to a point in time

GET

/projects/{project_id}/operations/{operation_id}

Get operation status

GET

/api_keys

List API keys

POST

/api_keys

Mint an API key

DELETE

/api_keys/{key_id}

Revoke an API key

GET

/projects

List Neon projects

POST

/projects

Create a new Neon project

GET

/projects/{project_id}

Get a project by id

POST

/projects/{project_id}/restore

Restore a branch to a point in time

GET

/projects/{project_id}/operations/{operation_id}

Get operation status

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Neon bearer keys are stored encrypted in the Jentic MAXsystem vault. Agents receive scoped access at execution time and the raw key never enters the agent context.

Intent-based discovery

Agents search Jentic by intent (for example, create a neon branch) and Jentic returns the matching operation with its input schema, so the agent calls the right endpoint without reading the docs.

Time to first call

Direct Neon integration: 1-2 days for auth, branch and endpoint orchestration, and operation polling. Through Jentic: under 1 hour to search, load, and execute.

FAQs

Specific to using Neon API through Jentic.

What authentication does the Neon API use?

The Neon API uses bearer tokens (BearerAuth in the spec). Mint a key in the Neon console or via /api_keys, store it in the Jentic vault, and pass it as Authorization: Bearer in every request. Cookie auth is also supported for the web console but not for programmatic clients.

Can I create a database branch with the Neon API?

Yes. POST to the branches endpoint under /projects/{project_id} with a parent_id and an optional point-in-time. Neon returns the new branch immediately and a compute endpoint can be attached for read-write access.

How do I provision a Neon project through Jentic?

Search Jentic for create a neon project, load the schema for POST /projects, then execute with the project name, region, and Postgres version. The full flow is pip install jentic, search, load, execute.

What are the rate limits for the Neon API?

Neon enforces account-level concurrency and rate limits that vary by plan. The spec does not include numeric per-second caps, so treat heavy automation as bursty and back off on 429s. Long-running actions return an operation id under /projects/{project_id}/operations.

Can I restore a Neon branch to a previous point in time?

Yes. POST /projects/{project_id}/restore with the source branch and a timestamp inside the project history retention window. Neon creates a new branch at that state and returns an operation id for status tracking.

How do I mint a Neon API key for a CI runner?

POST /api_keys with a name. Neon returns the key once, in the response body — store it in the Jentic vault immediately. List existing keys with GET /api_keys and revoke with DELETE /api_keys/{key_id}.

Neon Tech Neon API

Connect the Neon API to your agent

Capabilities

Start building with Neon API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs