Forge Capsule

API Design: REST Best Practices for AI Knowledge Platforms

REST API design: resource naming (nouns not verbs), HTTP methods semantics (GET idempotent, POST creates, PUT replaces, PATCH partial), status codes (201 Created, 204 No Content, 422 Validation Error, 429 Rate Limit). Versioning: URL path (/v1/) vs header. Pagination: cursor-based for large sets, offset for small. Rate limiting: token bucket, sliding window, per-user limits. Hypermedia: HATEOAS for discoverability. OpenAPI 3.1: machine-readable spec for SDK generation. Forge: 1,168 paths, Swagger UI, llms.txt for AI agents.