Write documentation for this API endpoint.

Endpoint: {{endpoint}}
Method: {{method}}
Format: {{format}}

Include: purpose, request parameters (with types), example request, example response, error codes, and usage notes.

Code/spec:
{{code_or_spec}}