Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion content/docs/ai-gateway/anthropic-messages.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,14 @@
---
title: Anthropic Messages API
tag: new
tagTheme: green
subtitle: Use the Anthropic SDK with Neon AI Gateway
summary: >-
The Anthropic Messages endpoint lets you use the Anthropic SDK with Neon AI
Gateway by changing only the base URL. Supports streaming, prompt caching,
and extended thinking on Claude models.
enableTableOfContents: true
updatedOn: '2026-08-06T17:43:14.909Z'
updatedOn: '2026-09-01T16:04:17.197Z'
---

<FeatureBetaProps feature_name="Neon AI Gateway" />
Expand Down
2 changes: 2 additions & 0 deletions content/docs/ai/ai-grok-bot-plugin.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
---
title: Grok Bot plugin for Neon
tag: new
tagTheme: green
summary: >-
Connect Neon to Grok Bot so you can create projects, work with branches and
run SQL from chat.
Expand Down
2 changes: 2 additions & 0 deletions content/docs/cli/ask.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
---
title: 'Neon CLI command: ask'
tag: new
tagTheme: green
subtitle: 'Ask the Neon assistant a question from the terminal'
summary: >-
The Neon CLI `ask` command sends a question to the Neon assistant and prints
Expand Down
2 changes: 2 additions & 0 deletions content/docs/cli/claim.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
---
title: 'Neon CLI command: claim'
tag: new
tagTheme: green
subtitle: Create and claim a temporary Neon project without an account
summary: >-
The Neon CLI `claim` command (`neon claimable` is an alias) creates a
Expand Down
4 changes: 3 additions & 1 deletion content/docs/cli/logs.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
---
title: 'Neon CLI command: logs'
tag: new
tagTheme: green
subtitle: Query the logs a branch's services emit
summary: >-
The Neon CLI `neon logs` command reads the logs a branch's services emit.
Expand All @@ -9,7 +11,7 @@ summary: >-
LogQL, and list which fields and values a branch reports. Logs are in beta
and available only in AWS US East (Ohio) (aws-us-east-2).
enableTableOfContents: true
updatedOn: '2026-08-26T13:16:52.511Z'
updatedOn: '2026-09-01T16:04:17.197Z'
---

<FeatureBeta />
Expand Down
2 changes: 2 additions & 0 deletions content/docs/cli/mcp.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
---
title: 'Neon CLI command: mcp'
tag: new
tagTheme: green
subtitle: 'Install the Neon MCP Server into your coding agents'
summary: >-
The Neon CLI `mcp` command installs the [Neon MCP Server](/docs/ai/neon-mcp-server)
Expand Down
2 changes: 2 additions & 0 deletions content/docs/cli/open.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
---
title: 'Neon CLI command: open'
tag: new
tagTheme: green
subtitle: 'Open the linked project in the Neon Console in your browser'
summary: >-
The Neon CLI `open` command opens your linked project's dashboard in the Neon
Expand Down
2 changes: 2 additions & 0 deletions content/docs/cli/plugins.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
---
title: 'Neon CLI command: plugins'
tag: new
tagTheme: green
subtitle: 'Install the Neon plugin into coding agents that support plugin marketplaces'
summary: >-
The Neon CLI `plugins` command installs the `neon-postgres` plugin into
Expand Down
4 changes: 3 additions & 1 deletion content/docs/cli/skills.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
---
title: 'Neon CLI command: skills'
tag: new
tagTheme: green
subtitle: 'Install and update Neon agent skills in your coding agents'
summary: >-
The Neon CLI `skills` command installs [Neon agent skills](/docs/ai/agent-skills)
Expand All @@ -8,7 +10,7 @@ summary: >-
agents and skip the prompts. Use `neon skills update` to refresh installed
skills to their latest versions.
enableTableOfContents: true
updatedOn: '2026-08-28T19:48:06.838Z'
updatedOn: '2026-09-01T16:04:17.197Z'
---

The `skills` command installs [Neon agent skills](/docs/ai/agent-skills) into your coding agents, so tools like Cursor and Claude Code know how to work with Neon's Postgres, AI Gateway, Object Storage, and Functions.
Expand Down
2 changes: 2 additions & 0 deletions content/docs/compute/functions/discord-bot.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
---
title: How to host a Discord bot on Neon Functions
tag: new
tagTheme: green
subtitle: Receive slash commands at a public function URL with no Gateway connection
enableTableOfContents: true
isDraft: false
Expand Down
2 changes: 2 additions & 0 deletions content/docs/compute/functions/telegram-bot.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
---
title: How to host a Telegram bot on Neon Functions
tag: new
tagTheme: green
subtitle: Receive Telegram messages, run bot commands and store data in Postgres
enableTableOfContents: true
isDraft: false
Expand Down
2 changes: 2 additions & 0 deletions content/docs/compute/functions/whatsapp-bot.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
---
title: How to host a WhatsApp bot on Neon Functions
tag: new
tagTheme: green
subtitle: Receive WhatsApp messages and reply through the Graph API
enableTableOfContents: true
isDraft: false
Expand Down
4 changes: 1 addition & 3 deletions content/docs/guides/backup-restore.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,10 +9,8 @@ summary: >-
automated daily, weekly, or monthly backups. Snapshot storage is billed at
$0.09/GB-month. Scheduled snapshots do not count toward the manual snapshot
limit.
tag: new
tagTheme: green
enableTableOfContents: true
updatedOn: '2026-08-31T19:23:51.024Z'
updatedOn: '2026-09-01T14:50:06.167Z'
---

<Admonition type="note" title="Snapshots">
Expand Down
4 changes: 3 additions & 1 deletion content/docs/guides/kotlin.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
---
title: Connect a Kotlin application to Neon Postgres
tag: new
tagTheme: green
subtitle: Learn how to run SQL queries in Neon from Kotlin using the PostgreSQL JDBC
driver
summary: >-
Expand All @@ -9,7 +11,7 @@ summary: >-
and rollback. Also covers dotenv-kotlin for credential management. Focuses on
raw JDBC without an ORM, unlike Micronaut or Hibernate guides.
enableTableOfContents: true
updatedOn: '2026-07-17T21:07:05.131Z'
updatedOn: '2026-09-01T16:04:17.197Z'
---

<CopyPrompt src="/prompts/kotlin-prompt.md"
Expand Down
2 changes: 0 additions & 2 deletions content/docs/introduction/spending-notifications.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,8 +10,6 @@ summary: >-
redirectFrom:
- /docs/introduction/spending-limit
enableTableOfContents: true
tag: new
tagTheme: green
---

<InfoBlock>
Expand Down
2 changes: 2 additions & 0 deletions content/docs/manage/project-permissions-get-started.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
---
title: Get started with project permissions
tag: new
tagTheme: green
subtitle: Scope each person and agent to the projects they need, in about five minutes
summary: >-
A worked example that takes a four-person team from everyone-sees-everything
Expand Down
32 changes: 30 additions & 2 deletions content/docs/navigation.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -93,6 +93,8 @@
slug: guides/javascript
- title: Kotlin
slug: guides/kotlin
tag: new
tagTheme: green
- title: Python
slug: guides/python
- title: Rust
Expand Down Expand Up @@ -836,10 +838,16 @@
items:
- title: Discord bot
slug: compute/functions/discord-bot
tag: new
tagTheme: green
- title: Telegram bot
slug: compute/functions/telegram-bot
tag: new
tagTheme: green
- title: WhatsApp bot
slug: compute/functions/whatsapp-bot
tag: new
tagTheme: green
- section: Reference
items:
- title: Runtime limits
Expand Down Expand Up @@ -890,6 +898,8 @@
slug: ai-gateway/openai-responses
- title: Anthropic Messages API
slug: ai-gateway/anthropic-messages
tag: new
tagTheme: green
- title: Gemini API
slug: ai-gateway/gemini
- section: Reference
Expand All @@ -914,6 +924,8 @@
slug: manage/accounts
- title: Permissions quickstart
slug: manage/project-permissions-get-started
tag: new
tagTheme: green
- title: User permissions
slug: manage/user-permissions
- title: Organizations
Expand Down Expand Up @@ -1079,8 +1091,6 @@
slug: introduction/manage-billing
- title: Spending notifications
slug: introduction/spending-notifications
tag: new
tagTheme: green
- title: Monitor billing
slug: introduction/monitor-usage
- title: Usage and cost calculations
Expand Down Expand Up @@ -1121,6 +1131,8 @@
items:
- title: Claimable Neon
slug: reference/claimable-neon
tag: new
tagTheme: green
- section: Guides
icon: book
items:
Expand Down Expand Up @@ -1163,6 +1175,8 @@
slug: ai/ai-cursor-plugin
- title: Grok Bot plugin
slug: ai/ai-grok-bot-plugin
tag: new
tagTheme: green
- title: GitHub Copilot agents
slug: ai/ai-github-copilot-agents
- section: Build AI agents
Expand Down Expand Up @@ -1217,14 +1231,24 @@
slug: cli/init
- title: ask
slug: cli/ask
tag: new
tagTheme: green
- title: mcp
slug: cli/mcp
tag: new
tagTheme: green
- title: skills
slug: cli/skills
tag: new
tagTheme: green
- title: plugins
slug: cli/plugins
tag: new
tagTheme: green
- title: claim
slug: cli/claim
tag: new
tagTheme: green
- title: bootstrap
slug: cli/bootstrap
- title: link
Expand All @@ -1237,6 +1261,8 @@
slug: cli/set-context
- title: open
slug: cli/open
tag: new
tagTheme: green
- title: me
slug: cli/me
- title: profile
Expand Down Expand Up @@ -1303,6 +1329,8 @@
slug: cli/inspect
- title: logs
slug: cli/logs
tag: new
tagTheme: green
- section: API
icon: api
items:
Expand Down
38 changes: 20 additions & 18 deletions content/docs/reference/claimable-neon.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
---
title: Claimable Neon
tag: new
tagTheme: green
subtitle: CLI, claim, and HTTP reference
summary: >-
If an agent needs a Neon account and the user is not around, provision a
Expand All @@ -10,7 +12,7 @@ redirectFrom:
- /docs/reference/neon-launchpad
- /docs/reference/instagres
- /docs/reference/claimable-postgres
updatedOn: '2026-08-26T18:00:00.000Z'
updatedOn: '2026-09-01T16:04:17.197Z'
---

If an agent needs a Neon account and the user is not around, it provisions a project now. A human claims it later if they want to keep it. The agent receives credentials scoped to one project, builds with standard Postgres tools, and hands over a claim link. Unclaimed projects expire in 72 hours (`project.expires_at`) and are capped at 100 MB storage and 1 GB transfer. Claim codes expire in 15 minutes (`expires_in`). Those are two clocks.
Expand Down Expand Up @@ -193,14 +195,14 @@ Only requested and granted services appear under `services`.

## Capabilities

| Capability | Available before claim | Environment variable |
| ------------------- | ---------------------- | ----------------------------- |
| Postgres | Yes | `DATABASE_URL` |
| Capability | Available before claim | Environment variable |
| ------------------- | ------------------------------------------- | ----------------------------- |
| Postgres | Yes | `DATABASE_URL` |
| Data API | When requested, or later with `neon deploy` | `NEON_DATA_API_URL` |
| Managed Better Auth | When requested, or later with `neon deploy` | `NEON_AUTH_BASE_URL` |
| Functions | No | Requires claiming the project |
| Object Storage | No | Requires claiming the project |
| AI Gateway | No | Requires claiming the project |
| Functions | No | Requires claiming the project |
| Object Storage | No | Requires claiming the project |
| AI Gateway | No | Requires claiming the project |

Registration records those as `{ granted: false, reason: "requires_claim" }`. A later protected operation returns `capability_requires_claim`. Preserve the denied capability and give the human a claim link; do not retry or drop it.

Expand Down Expand Up @@ -330,18 +332,18 @@ Use `error.code` for control flow and show `error.message` to the user. Retry on

Common codes include:

| Code | Meaning |
| --------------------------- | ------------------------------------------------------------ |
| `invalid_request` | The request body or parameter is invalid |
| `invalid_grant` | The identity assertion cannot be exchanged. Discard it |
| `unauthorized` | No credential was presented, or it did not verify |
| `token_expired` | The access token expired. Re-exchange the identity assertion |
| `scope_insufficient` | The access token does not permit the operation |
| `capability_requires_claim` | The requested service or operation requires human ownership |
| Code | Meaning |
| --------------------------- | -------------------------------------------------------------------------------- |
| `invalid_request` | The request body or parameter is invalid |
| `invalid_grant` | The identity assertion cannot be exchanged. Discard it |
| `unauthorized` | No credential was presented, or it did not verify |
| `token_expired` | The access token expired. Re-exchange the identity assertion |
| `scope_insufficient` | The access token does not permit the operation |
| `capability_requires_claim` | The requested service or operation requires human ownership |
| `claim_in_progress` | The transfer window is still live. Poll status; mint a new code after it expires |
| `project_claimed` | The project transferred. Discard the identity assertion |
| `project_expired` | The unclaimed window closed. Discard the identity assertion |
| `upstream_error` | A Neon API or service dependency failed |
| `project_claimed` | The project transferred. Discard the identity assertion |
| `project_expired` | The unclaimed window closed. Discard the identity assertion |
| `upstream_error` | A Neon API or service dependency failed |

## Resources

Expand Down
4 changes: 1 addition & 3 deletions content/docs/workflows/data-anonymization.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,10 +11,8 @@ summary: >-
and the branch is unavailable while anonymization runs.
redirectFrom:
- /docs/concepts/anonymized-data
tag: new
tagTheme: green
enableTableOfContents: true
updatedOn: '2026-08-18T10:29:02.410Z'
updatedOn: '2026-09-01T14:50:06.167Z'
---

<FeatureBeta />
Expand Down
Loading