Write an API reference doc

Write a developer-facing API reference for the following endpoints: [List endpoints with HTTP method, path, and brief purpose]. For each endpoint provide a clear description, list all request headers including authentication, document every path, query, and body parameter with its type and whether it is required, show the full response schema with a realistic example JSON payload, and document every possible error code with its meaning.