API Overview (auth, rate limits) 🔌

Build automations and integrations with the Neon Cloud REST API.

Insert screenshot of Profile → API Tokens and API Docs here

Auth 🔑

• Create a token in Profile → API Tokens

• Use Bearer auth in the Authorization header

export NEON_TOKEN=<your-token>
curl -H "Authorization: Bearer $NEON_TOKEN" https://api.neoncloud.com/v1/me

Base URL

• https://api.neoncloud.com/v1 (replace with actual if different)

Rate limits ⏱️

• Limits are enforced per token and endpoint

• Check response headers like X-RateLimit-Limit, X-RateLimit-Remaining, and Retry-After (if supported)

• Back off and retry with jitter

Pagination 📄

• Cursor/offset style (see page, per_page, next links) (implementation may vary)

Errors

Code	Meaning
400	Bad request / validation error
401	Unauthorized / invalid token
403	Forbidden / missing permission
404	Not found
409	Conflict
429	Rate limit exceeded
5xx	Service error