API Documentation Builder

Generate OpenAPI 3.0 documentation for this API endpoint:
Method: [GET/POST/etc.]
Path: [/path]
Function: [what it does]

Include: description, parameters (with types, constraints, examples), request body schema, all response codes (200, 400, 401, 404, 500) with example payloads, authentication requirements, rate limits, and 3 curl example calls. Follow REST best practices.