# DigitalOcean — API Agent Score

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

DigitalOcean scored 80/100 (A), classified "ai-ready".

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

## Summary

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

## Category Scores

- API Design: 87/100 (A)
- Developer Experience: 75/100 (B)
- Agent Discovery: 93/100 (A+)
- Agent Understanding: 77/100 (B)
- Agent Usability: 71/100 (B)

## Check Results

### API Design

- [pass] Auth declared & discoverable — Authentication required (global or on every operation). Investigated: spec 100%, docs 100%.
- [warn] Machine-readable, versioned contract — info.version="2.0" set but no versioning scheme (URL / header / media type) detected. Investigated: spec 75%, docs 50%.
- [warn] Schema coverage & depth — 84% of operations have documented schemas (target 95%+). Investigated: spec 67%, sdk 60%.
- [pass] Security & governance hygiene — No credential-shaped strings detected in spec. Investigated: spec 100%, wellknown 50%.
- [pass] Example coverage — 94% example coverage across params + responses. Investigated: spec 100%, sdk 100%, docs 0%.

### Developer Experience

- [pass] Self-service developer portal — Signup page at https://www.digitalocean.com/; no free-tier language detected in docs/pricing. Investigated: docs 100%.
- [pass] Description completeness — 99% of operations + parameters have substantive descriptions. Investigated: spec 100%, sdk 98%.
- [pass] Changelog published — changelog documented in the docs site at https://docs.digitalocean.com/release-notes/. Investigated: spec 100%, docs 100%, sdk 100%.
- [warn] Quickstart present — Quickstart page reachable (1 variants scanned starting at https://docs.digitalocean.com/products/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 20 sampled docs pages. Investigated: docs 0%.

### Agent Discovery

- [pass] Docs reachable, not hard auth-gated — All 50 sampled pages are publicly accessible. Investigated: docs 100%.
- [pass] Registry & SDK presence — Indexed on Context7 (websites/digitalocean, 55277 snippets). Investigated: docs 100%, sdk 67%, cli 0%, mcp 0%, wellknown 0%.
- [warn] llms.txt present, valid & comprehensive — llms.txt covers 274/4463 sitemap doc pages (6%); 4189 missing; 7 llms.txt links not in sitemap (may indicate stale links or incomplete sitemap). Investigated: docs 75%, sdk 0%.
- [pass] Crawlable / AEO — Docs paths crawlable by all monitored AI agents. Investigated: wellknown 100%.

### Agent Understanding

- [pass] Machine-readable errors (RFC 9457) — 10 distinct 4xx/5xx response codes documented. Investigated: docs 100%, sdk 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 — 1 of 49 pages have substantive content differences between markdown and HTML (avg 2% missing). Investigated: docs 50%.
- [pass] Docs structured data — JSON-LD Article markup on 16/16 assessed pages (100%) with dateModified present. Investigated: docs 100%.
- [warn] Description consistency across surfaces — Mean pairwise description similarity across 2 surfaces (docs, sdk) is 5% (threshold 35% for full credit).
- [fail] Agent instructions file (AGENTS.md) — No AGENTS.md at the site root or /.well-known/. Investigated: wellknown 0%.

### Agent Usability

- [pass] Rate-limit signaling — 3 distinct rate-limit response headers documented. Investigated: spec 100%, docs 100%.
- [pass] Pagination documented & consistent — Pagination params detected on 4 list endpoint(s). Investigated: spec 100%, docs 100%.
- [pass] Sandbox separation — Sandbox environments are exposed (sandbox). Investigated: sdk 100%, spec 0%, docs 0%.
- [fail] Idempotency documented — 0% of mutating operations document idempotency. Investigated: spec 0%, docs 0%, sdk 0%.
- [fail] Runnable collection with test scripts — No public Postman workspace discovered for the org. Investigated: platform 0%.

## Executive Summary

DigitalOcean's API program demonstrates strong discovery and contract quality, giving partners a solid foundation to find and evaluate your APIs. However, two areas are holding back partner and agent activation: agents lack the structured context files and runnable workflow examples they need to integrate correctly without guesswork, and partners hit friction during onboarding due to missing inline code samples and undocumented idempotency behavior. Prioritizing agent-ready context, a runnable collection with test coverage, and inline code samples will meaningfully accelerate partner integration and reduce support overhead.