Missing content for "Responses API: Update item definitions"

Documentation
1

The section “Update item definitions“ of the Response API doc has the same content as the second part of the section “1. Update generation endpoints”

The content needs to be updated to describe how to update item definitions.

1 Like
2

I can confirm the issue with the documentation that needs to be fixed.

The page is " Migrate to the Responses API "

Here is the link:

It is hard to even know what an “item definition” is even supposed to be, where then the page repeats the previous step 1 description and code.

Maybe it is the multiple items that message content can hold, image or file, which differ in type designation between the endpoints.

response = client.responses.create(
  model="gpt-4.1-nano",
  input=[
    {
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "Hello"
        },
        {
          "type": "input_image",
          "image_url": "data:image/jpeg;base64,..."
        },
        {
          "type": "input_file",
          "filename": "randoms.txt",
          "file_data": "data:text/plain;base64,c2stWVR...SFFPCg=="
        }
      ]
    },

response = client.chat.completions.create(
  model="gpt-4.1-nano",
  messages=[
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "What's in the text file?"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "data:image/jpeg;base64,..."
          }
        },
        {
          "type": "file",
          "file": {
            "filename": "randoms.txt",
            "file_data": "data:text/plain;base64,c2stWVR...NZSFFPCg=="
          }
        }
      ]
    },

It is unlikely to be “items” of output, or events of a stream documented there. You get to deal with 60 different event types that can be returned on Responses, instead of merely text or tool deltas.