# Responses API documentation on structured outputs is lacking

**URL:** <https://community.openai.com/t/responses-api-documentation-on-structured-outputs-is-lacking/1356632>\
**Category:** Documentation\
**Tags:** structured-output, responses-api\
**Created:** [September 6, 2025, 8:51am UTC](https://community.openai.com/t/responses-api-documentation-on-structured-outputs-is-lacking/1356632 "2025-09-06T08:51:51Z")\
**Posts on this page:** 1\
**Showing post:** 3

<div class="post-metadata">

**Author:** ![Jemmery](https://sea2.discourse-cdn.com/openai1/user_avatar/community.openai.com/jemmery/32/146819_2.png) [@Jemmery](https://community.openai.com/u/Jemmery)\
**Post date:** [September 7, 2025, 7:55am UTC](https://community.openai.com/t/responses-api-documentation-on-structured-outputs-is-lacking/1356632/3 "2025-09-07T07:55:58Z")

</div>

I gave up and stuck with chat completions for much the same reason. I just could not work out how to get the json schema setup right for the responses api. The documentation looks good but then transpires to just be lacking in necessary detail in so many places!

---

_[View the full topic](https://community.openai.com/t/responses-api-documentation-on-structured-outputs-is-lacking/1356632)._