Documentation: Update API reference

[samudzi]

Update the API reference documentation with new endpoints.

🧪 Test Criteria for Completion

API Tests (Required - CLAUDE.md Compliance)

• Endpoint Availability: GET/POST requests return proper HTTP status codes
• Response Format: JSON responses match documented schema
• Authentication: Proper Auth0 JWT validation for protected endpoints
• Error Handling: 4xx/5xx errors return informative error messages
• Load Testing: Endpoint handles concurrent requests without timeouts

Integration Tests (Required)

• Cross-Region: API works in both us-east-1 and af-south-1 regions
• Database: Database queries execute successfully and return valid data
• External Services: Integration with weather APIs, Auth0, Stripe functions correctly

Deployment Verification (Critical)

• US-EAST-1: Endpoint accessible at discovered AWS API Gateway endpoints
• AF-SOUTH-1: Endpoint accessible at discovered AWS API Gateway endpoints
• Health Checks: /health endpoint returns 200 with system status
• Monitoring: CloudWatch logs show no error patterns

Test Completion Required: All checkboxes must pass before marking issue as Done.
Auto-generated by Ona Platform Test Criteria Automation