AI agents for Neon

List projects

Lists the Neon projects the key can reach, as projects: each with its id (the project ID other actions take), name, region_id, pg_version, created_at and storage use.

List branches

Lists a project's branches, newest change first, as branches: each with its id (br-…), name, parent_id, whether it is the default branch, whether it is protected, current_state and created_at.

List databases

Lists the Postgres databases on a branch, as databases: each with its name (the name other actions take), owner_name (the role that owns it) and created_at.

Get a database's schema

Reads a database's schema on a branch as SQL DDL in sql: every table with its columns, types, defaults, keys and indexes, and the views, functions and other objects (no data).

Compare two branches' schemas

Shows how a database's schema on one branch differs from another branch (its parent when base_branch_id is left out), as a unified diff of the SQL DDL in diff.

Create a branch

Creates a copy-on-write branch of a project's data, instantly and without copying.

Delete a branchDeletes data

Deletes a branch with its databases and computes, breaking any open connections to it.