{"data":{"@kind":"feedback_endpoint","description":"POST a structured feedback report. We read every report. Contract drift gets fixed within a week; we reply with the commit SHA.","method":"POST","body_required":{"kind":["contract-drift","guide-feedback","endpoint-suggestion","federation-adopter","general"],"reporter_contact":"email or URL where we can reply"},"body_per_kind":{"contract-drift":{"endpoint":"the path that produced the unexpected response","observed":"what you got","expected":"what the OpenAPI spec says (or what's documented)","request_id_to_correlate":"(optional) the X-Request-Id from our response"},"guide-feedback":{"guide_slug":"the slug of the guide (from /api/v1/guides)","step_number":"(optional) which step had the issue","observation":"what you observed","expected":"what you expected"},"endpoint-suggestion":{"proposed_endpoint":"the path you'd like to see","use_case":"what you'd build with it"},"federation-adopter":{"platform_name":"your platform's display name","platform_url":"your platform's URL","federation_endpoint":"your /api/v1/federation/identify/[hash] implementation URL"},"general":{"message":"free-form text"}},"response_window_hours":48,"example_curl":"curl -X POST https://cambridgetcg.com/api/v1/feedback \\\n  -H 'content-type: application/json' \\\n  -d '{ \"kind\": \"general\", \"message\": \"hello\", \"reporter_contact\": \"you@example.com\" }'"},"_meta":{"spec_version":"1","endpoint":"/api/v1/feedback","retrieved_at":"2026-05-13T18:56:06.611Z","as_of":"2026-05-13T18:56:06.611Z","sources":["ctcg-derived"],"freshness_seconds":86400,"license":"CC0-1.0","request_id":"req_c2e85096-20f","deprecation":null,"next_link":null,"self_reference":{"this_endpoint":"/api/v1/feedback","contains_self":true},"source_license":["CC0-1.0"]}}