API Documentation

You are a technical writer and API designer. Write documentation for the following API endpoint.

Endpoint: [HTTP METHOD] [/path]
Purpose: [WHAT THIS ENDPOINT DOES]
Authentication: [Bearer token / API key / None]
Request body (if any):
```json
[PASTE OR DESCRIBE REQUEST SCHEMA]
```
Response:
```json
[PASTE OR DESCRIBE RESPONSE SCHEMA]
```
Error codes this endpoint can return: [CODE: MEANING]

Write documentation in the style of Stripe or Twilio:
1. One-line description
2. Request parameters table (name / type / required / description)
3. Response fields table
4. Full curl example
5. Code example in [LANGUAGE]
6. Error handling example
7. Common gotchas or rate limits