# Discord — API Agent Score

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

Discord scored 82/100 (A), classified "ai-ready".

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

## Summary

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

## Category Scores

- API Design: 97/100 (A+)
- Developer Experience: 62/100 (C)
- Agent Discovery: 87/100 (A)
- Agent Understanding: 67/100 (C)
- Agent Usability: 96/100 (A+)

## Check Results

### API Design

- [pass] Machine-readable, versioned contract — Versioning declared (info.version="10") 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%, wellknown 0%.
- [warn] Schema coverage & depth — 0/80 (0%) enum-like params are realized as constrained types (not bare strings). Investigated: sdk 85%, spec 50%.
- [pass] Security & governance hygiene — No credential-shaped strings detected in spec. Investigated: spec 100%, wellknown 100%.
- [pass] Example coverage — README is present and includes a runnable quickstart. Investigated: sdk 100%, spec 0%, docs 0%.

### Developer Experience

- [pass] Self-service developer portal — Signup page at https://discord.com/register; no free-tier language detected in docs/pricing. Investigated: docs 100%.
- [pass] Changelog published — Newest official SDK activity 79 day(s) ago. Investigated: sdk 100%, spec 0%, docs 0%.
- [warn] Description completeness — 1079/2526 operations lack a description. Investigated: sdk 57%, spec 0%.
- [fail] Quickstart present — No quickstart/getting-started page found at the conventional paths. Investigated: docs 0%.
- [fail] Code samples in docs — No detectable code samples across 20 sampled docs pages. Investigated: docs 0%.

### Agent Discovery

- [pass] Registry & SDK presence — Indexed on Context7 (discord/discord-api-docs, 4239 snippets). Investigated: docs 100%, sdk 100%, cli 0%.
- [warn] llms.txt present, valid & comprehensive — No /llms-full.txt found at the candidate origins. Investigated: docs 75%, sdk 0%.
- [warn] Docs reachable, not hard auth-gated — Could not test any URLs; 1 failed to fetch. Investigated: docs 75%.
- [pass] Crawlable / AEO — Docs paths crawlable by all monitored AI agents. Investigated: wellknown 100%.

### Agent Understanding

- [pass] Machine-readable errors (RFC 9457) — Only 1 distinct 4xx/5xx codes documented (plus 0 "default" catch-all responses). Investigated: docs 100%, sdk 100%, spec 50%.
- [pass] Agent-navigable, token-efficient docs — All 1 pages contain server-rendered content. Investigated: docs 100%.
- [pass] Docs structured data — JSON-LD Article markup on 17/17 assessed pages (100%) with dateModified present. Investigated: docs 100%.
- [warn] Description consistency across surfaces — Mean pairwise description similarity across 2 surfaces (spec, docs) is 5% (threshold 35% for full credit).
- [fail] Operation purpose clarity — 0% of operations are agent-inferable. Investigated: spec 0%.
- [fail] Agent instructions file (AGENTS.md) — No AGENTS.md at the site root or /.well-known/. Investigated: wellknown 0%.

### Agent Usability

- [pass] Idempotency documented — Built-in retry machinery is present (grep-derived). Investigated: sdk 100%, spec 0%, docs 0%.
- [pass] Rate-limit signaling — 5 distinct rate-limit response headers documented. Investigated: spec 100%, docs 100%.
- [pass] Pagination documented & consistent — Pagination params detected on 14 list endpoint(s). Investigated: spec 100%, docs 100%, sdk 0%.
- [pass] Sandbox separation — Sandbox environments are exposed (sandbox). Investigated: sdk 100%, spec 0%, docs 0%.
- [warn] Runnable collection with test scripts — No test scripts found in the workspace's collections. Investigated: platform 50%.

## Executive Summary

Discord's API design and agent usability foundations are strong, giving partners a reliable contract to build against. The most urgent gaps are in agent understanding and developer onboarding: operations lack clear purpose descriptions, there is no machine-readable agent instructions file to orient AI agents, and partners have no quickstart or inline code samples to reach a first working call without digging through reference docs. Prioritizing semantic documentation quality and onboarding acceleration will unlock faster partner integration and make Discord's APIs immediately usable by both humans and AI agents.