# Persona — API Agent Score

> Score: 81/100 (Grade: A) | Domain: withpersona.com | Rubric: 1.0.0 | Checked: July 24, 2026

Persona scored 81/100 (A), classified "ai-ready".

[View full report](https://www.postman.com/ai/ai-ready-apis/company/withpersona)
[All organizations](https://www.postman.com/ai/ai-ready-apis/llms.txt)

## Summary

- Overall: 81/100 (A)
- Classification: ai-ready

## Category Scores

- API Design: 89/100 (A)
- Developer Experience: 75/100 (B)
- Agent Discovery: 85/100 (A)
- Agent Understanding: 82/100 (A)
- Agent Usability: 76/100 (B)

## Check Results

### API Design

- [pass] Machine-readable, versioned contract — Versioning declared (info.version="2025-12-08") and url-versioning detected. Investigated: spec 100%, docs 100%.
- [pass] Auth declared & discoverable — Authentication required (global or on every operation). Investigated: spec 100%, docs 100%.
- [pass] Security & governance hygiene — No credential-shaped strings detected in spec. Investigated: spec 100%, wellknown 100%.
- [warn] Schema coverage & depth — High parameter complexity (avg 5.5 params/op + nested params). Investigated: spec 50%.
- [pass] Example coverage — 65% example coverage (target 80%+). Investigated: spec 100%, docs 0%.

### Developer Experience

- [pass] Self-service developer portal — Signup page at https://app.withpersona.com/dashboard/signup; no free-tier language detected in docs/pricing. Investigated: docs 100%.
- [pass] Description completeness — 79% description completeness (target 90%+). Investigated: spec 100%.
- [pass] Changelog published — changelog documented in the docs site at https://docs.withpersona.com/changelog. Investigated: spec 100%, docs 100%, sdk 100%.
- [warn] Quickstart present — Quickstart page reachable (2 variants scanned starting at https://docs.withpersona.com/getting-started) but no runnable code sample detected in HTML or .md variant. Investigated: docs 50%.
- [fail] Code samples in docs — No detectable code samples across 4 sampled docs pages. Investigated: docs 0%.

### Agent Discovery

- [pass] Registry & SDK presence — Indexed on Context7 (websites/withpersona, 9604 snippets). Investigated: docs 100%, sdk 50%, cli 0%.
- [warn] llms.txt present, valid & comprehensive — llms.txt covers 0/1 sitemap doc pages (0%); 1 missing. Investigated: docs 75%.
- [warn] Docs reachable, not hard auth-gated — Could not test any URLs; 1 failed to fetch. Investigated: docs 75%.
- [warn] Crawlable / AEO — Sitemap lastmod coverage 30% or newest entry older than 90 days. Investigated: wellknown 75%.

### Agent Understanding

- [pass] Machine-readable errors (RFC 9457) — 9 distinct 4xx/5xx response codes documented. Investigated: docs 100%, spec 50%.
- [pass] Operation purpose clarity — 100% of operations have a clear summary + operationId an agent can select on. Investigated: spec 100%.
- [warn] Agent-navigable, token-efficient docs — 2 of 4 endpoints have aggressive caching or missing cache headers. Investigated: docs 90%.
- [fail] Agent instructions file (AGENTS.md) — No AGENTS.md at the site root or /.well-known/. Investigated: wellknown 0%.
- [fail] Docs structured data — Neither JSON-LD nor OpenGraph/meta tags detected across 4 sampled pages — likely a CSR-only docs site. Investigated: docs 0%.
- [skip] Description consistency across surfaces — Only 0 surface description(s) with ≥6 tokens available; need at least 2 to compare.

### Agent Usability

- [pass] Idempotency documented — 97% of mutating operations document idempotency. Investigated: spec 100%, docs 100%.
- [pass] Rate-limit signaling — 3 distinct rate-limit response headers documented. Investigated: spec 100%, docs 100%.
- [pass] Pagination documented & consistent — Pagination params detected on 21 list endpoint(s). Investigated: spec 100%, docs 100%.
- [fail] Sandbox separation — No sandbox/test server declared across 1 server entries; no test-key prefixes documented. Investigated: spec 0%, docs 0%.
- [fail] Runnable collection with test scripts — No public Postman workspace discovered for the org. Investigated: platform 0%.

## Executive Summary

Withpersona's API program shows strong discoverability fundamentals and solid API design, but two areas pose real risk to partner and agent adoption: agents and AI coding tools lack the structured context they need to understand and act on your APIs without guessing, and partners have no safe, runnable environment to validate integrations before touching production. Closing the agent-context and sandbox gaps should be the immediate priority, followed by rounding out onboarding with inline code samples to compress the time from discovery to a partner's first successful call.