# Yoofooz API Readiness Report

## API
**Name:** Neon API
**Docs URL:** https://api-docs.neon.tech/reference/ai-agents
**Domain:** api-docs.neon.tech
**Generated At:** 2026-10-05T23:14:28.318569+00:00

## Certification
**Agent Readiness Score:** 80/100
**Certification Level:** Yoofooz Ready

## Agent Commerce Readiness
**Agent Commerce Score:** 50/100
**Agent Commerce Level:** Agent Commerce Emerging

This score is separate from the core Agent Readiness Score and evaluates MCP support, scoped agent identity, machine-native payments, consumption pricing, budget controls, rate controls, deterministic errors, auditability, least-privilege security, and agent observability.

## Category Scores
- Documentation Clarity: 10
- Machine Readable Spec: 10
- Authentication Clarity: 10
- Error Handling: 10
- Rate Limit Clarity: 10
- Agent Safe Workflow Support: 5
- Sandbox Availability: 0
- Webhook Event Support: 10
- Commercial Trust: 5
- Developer Experience: 10

## Strengths
- Documentation clarity
- Machine-readable specification (OpenAPI/GraphQL/etc.)
- Authentication model clarity
- Error handling and status codes
- Rate-limit / quota behavior
- Webhook / event support
- Developer experience (SDKs, quickstart, CLI)

## Risks
- Agent-safe workflow primitives (idempotency, retries) signal is partial; clearer documentation recommended.
- Sandbox / test-mode availability signal not detected in docs.
- Commercial trust (status, SLA, compliance) signal is partial; clearer documentation recommended.

## Recommended Next Steps
- Strengthen: Document idempotency keys, test mode, dry runs, and safe retry semantics for agents.
- Provide a sandbox / test mode with test API keys for safe agent testing.
- Strengthen: Publish status page, SLA, and security/compliance posture (SOC 2, GDPR, PCI as applicable).

## Evidence Signals

### Documentation clarity
- **Source:** https://api-docs.neon.tech/reference/getneonauthwebhookconfig
- **Matched:** parameters, request, response, examples, docs, reference
- **Evidence:** "...number plugin configuration update phone number plugin configuration send test email using the saved email provider authentication pagination path parameters sdks and providers for the neon api neon api for ai agents api rate limiting auth (legacy) create neon auth integration list trusted redirect uri..."

- **Source:** https://api-docs.neon.tech/reference/updateneonauthwebhookconfig
- **Matched:** parameters, request, response, examples, docs, reference
- **Evidence:** "...number plugin configuration update phone number plugin configuration send test email using the saved email provider authentication pagination path parameters sdks and providers for the neon api neon api for ai agents api rate limiting auth (legacy) create neon auth integration list trusted redirect uri..."

### Machine-readable specification (OpenAPI/GraphQL/etc.)
- **Source:** https://api-docs.neon.tech/reference/ai-agents
- **Matched:** openapi, api spec, api reference, endpoints, schema
- **Evidence:** "for ai agents: visit https://api-docs.neon.tech/llms.txt for an index of all pages formatted in markdown and endpoints in openapi. append .md to any documentation page url to get its markdown version. jump to content neon openapi specification neon docs neon console discord api..."

- **Source:** https://api-docs.neon.tech/reference/api-rate-limiting
- **Matched:** openapi, api spec, api reference, endpoints, schema
- **Evidence:** "for ai agents: visit https://api-docs.neon.tech/llms.txt for an index of all pages formatted in markdown and endpoints in openapi. append .md to any documentation page url to get its markdown version. jump to content neon openapi specification neon docs neon console discord api..."

### Authentication model clarity
- **Source:** https://api-docs.neon.tech/llms.txt
- **Matched:** bearer token, oauth, authentication, api key, keys
- **Evidence:** "...returns authentication details for the credentials used in the request, including the credential type (api key, bearer token, or oauth session) and the associated identity. - [retrieve project consumption metrics (legacy..."

- **Source:** https://api-docs.neon.tech/reference/addbranchneonauthoauthprovider
- **Matched:** oauth, client secret, authentication, api key, keys
- **Evidence:** "...neon docs neon console discord api reference v2.0 neon openapi specification neon docs neon console discord api reference v2.0 api reference add an oauth provider neon api neon api reference api key list api keys create api key revoke api key operation retrieve operation details list operations..."

### Error handling and status codes
- **Source:** https://api-docs.neon.tech/reference/getneonauthwebhookconfig
- **Matched:** 400, 500, retry
- **Evidence:** "...,'creation_source':'console','store_passwords':true,'branch_logical_size_limit_bytes':10500,'data_storage_bytes_hour':1040,'data_transfer_bytes':1000000,'written_data_bytes':100800,'compute_time_seconds':100,'active_time_seconds':100,'consum..."

- **Source:** https://api-docs.neon.tech/reference/updateneonauthwebhookconfig
- **Matched:** 400, 500, retry
- **Evidence:** "...,'creation_source':'console','store_passwords':true,'branch_logical_size_limit_bytes':10500,'data_storage_bytes_hour':1040,'data_transfer_bytes':1000000,'written_data_bytes':100800,'compute_time_seconds':100,'active_time_seconds':100,'consum..."

### Rate-limit / quota behavior
- **Source:** https://api-docs.neon.tech/reference/api-rate-limiting
- **Matched:** rate limit, too many requests, 429, limits
- **Evidence:** "...neon docs neon console discord api reference v2.0 neon openapi specification neon docs neon console discord api reference v2.0 api reference api rate limiting neon api neon api reference api key list api keys create api key revoke api key operation retrieve operation details list operations project list..."

- **Source:** https://api-docs.neon.tech/reference/getting-started-with-neon-api
- **Matched:** rate limit, 429
- **Evidence:** "...test email using the saved email provider authentication pagination path parameters sdks and providers for the neon api neon api for ai agents api rate limiting auth (legacy) create neon auth integration list trusted redirect uri domains add trusted redirect uri domain delete trusted redirect uri domain..."

### Agent-safe workflow primitives (idempotency, retries)
- **Source:** https://api-docs.neon.tech/reference/ai-agents
- **Matched:** metadata, validation
- **Evidence:** "for ai agents: visit https://api-docs.neon.tech/llms.txt for an index of all pages formatted in markdown and endpoints in openapi."

- **Source:** https://api-docs.neon.tech/reference/api-rate-limiting
- **Matched:** metadata, validation
- **Evidence:** "for ai agents: visit https://api-docs.neon.tech/llms.txt for an index of all pages formatted in markdown and endpoints in openapi."

### Webhook / event support
- **Source:** https://api-docs.neon.tech/reference/updateneonauthwebhookconfig
- **Matched:** webhooks, event types, webhook, events
- **Evidence:** "...configuration update neon data api copy page update neon auth webhook configuration put https://console.neon.tech/api/v2 /projects/ /branches/ /auth/webhooks updates the webhook configuration for the specified branch's neon auth integration. webhooks notify an external endpoint when auth events occur,..."

- **Source:** https://api-docs.neon.tech/reference/getneonauthwebhookconfig
- **Matched:** webhooks, webhook, events
- **Evidence:** "...update neon data api copy page retrieve neon auth webhook configuration get https://console.neon.tech/api/v2 /projects/ /branches/ /auth/webhooks returns the webhook configuration for the specified branch's neon auth integration, including the endpoint url and the events that trigger it. path..."

### Commercial trust (status, SLA, compliance)
- **Source:** https://api-docs.neon.tech/llms.txt
- **Matched:** support, security
- **Evidence:** "...number of branches](https://api-docs.neon.tech/reference/countprojectbranches.md): retrieves the total number of branches in the specified project. supports an optional `search` parameter to count branches matching a name filter. - [retrieve branch..."

- **Source:** https://api-docs.neon.tech/reference/getneonauthwebhookconfig
- **Matched:** support, security
- **Evidence:** "...create snapshot list project snapshots delete snapshot update snapshot restore snapshot retrieve backup schedule update backup schedule region list supported regions users retrieve current user details list organizations for the current user transfer projects from personal account to organization..."

### Developer experience (SDKs, quickstart, CLI)
- **Source:** https://api-docs.neon.tech/reference/ai-agents
- **Matched:** sdk, cli
- **Evidence:** "...configuration update phone number plugin configuration send test email using the saved email provider authentication pagination path parameters sdks and providers for the neon api neon api for ai agents api rate limiting auth (legacy) create neon auth integration list trusted redirect uri..."

- **Source:** https://api-docs.neon.tech/reference/getneonauthwebhookconfig
- **Matched:** sdk, cli
- **Evidence:** "...configuration update phone number plugin configuration send test email using the saved email provider authentication pagination path parameters sdks and providers for the neon api neon api for ai agents api rate limiting auth (legacy) create neon auth integration list trusted redirect uri..."

## AI Analyst Summary
AI analysis unavailable: NVIDIA analysis failed: http 410

## Yoofooz Summary
This API has been evaluated for autonomous AI-agent usability. The score reflects documentation quality, machine-readable specification signals, authentication clarity, error handling, workflow safety, commercial trust, and developer experience.