SpyBara
Go Premium

Reference 2026-08-13 22:00 UTC to 2026-08-14 20:01 UTC

42 files changed +28,513 −1,930. View all changes and history on the product overview
2026
Fri 14 20:01 Thu 13 22:00 Wed 12 16:01 Tue 11 22:59 Mon 10 22:00 Sat 8 00:59 Fri 7 21:59 Thu 6 18:59 Wed 5 02:01 Tue 4 22:59 Mon 3 21:58 Sat 1 01:00
Details

12173 for reasoning items returned by `POST /v1/responses` and WebSocket12173 for reasoning items returned by `POST /v1/responses` and WebSocket

12174 `response.create` requests.12174 `response.create` requests.

12175 12175 

12176 When streaming, use the completed reasoning item and its

12177 `encrypted_content` from the `response.output_item.done` event in

12178 subsequent requests. The `encrypted_content` in

12179 `response.output_item.added` may be incomplete. This is especially

12180 important when `store` is `false` or when using Zero Data Retention.

12181 

12176 - `status: optional "in_progress" or "completed" or "incomplete"`12182 - `status: optional "in_progress" or "completed" or "incomplete"`

12177 12183 

12178 The status of the item. One of `in_progress`, `completed`, or12184 The status of the item. One of `in_progress`, `completed`, or


12946 Unique identifier for the MCP tool call approval request.12952 Unique identifier for the MCP tool call approval request.

12947 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.12953 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

12948 12954 

12949 - `error: optional string or null`12955 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

12950 12956 

12951 The error from the tool call, if any.12957 The error from the tool call, if any.

12952 12958 

12959 - `string`

12960 

12961 The error from the tool call, if any.

12962 

12963 - `McpProtocolError object { code, message, type }`

12964 

12965 - `code: number`

12966 

12967 - `message: string`

12968 

12969 - `type: "mcp_protocol_error"`

12970 

12971 - `"mcp_protocol_error"`

12972 

12973 - `McpToolExecutionError object { content, type }`

12974 

12975 - `content: unknown`

12976 

12977 - `type: "mcp_tool_execution_error"`

12978 

12979 - `"mcp_tool_execution_error"`

12980 

12981 - `HTTPError object { code, message, type }`

12982 

12983 - `code: number`

12984 

12985 - `message: string`

12986 

12987 - `type: "http_error"`

12988 

12989 - `"http_error"`

12990 

12953 - `output: optional string or null`12991 - `output: optional string or null`

12954 12992 

12955 The output from the tool call.12993 The output from the tool call.


14235 for reasoning items returned by `POST /v1/responses` and WebSocket14273 for reasoning items returned by `POST /v1/responses` and WebSocket

14236 `response.create` requests.14274 `response.create` requests.

14237 14275 

14276 When streaming, use the completed reasoning item and its

14277 `encrypted_content` from the `response.output_item.done` event in

14278 subsequent requests. The `encrypted_content` in

14279 `response.output_item.added` may be incomplete. This is especially

14280 important when `store` is `false` or when using Zero Data Retention.

14281 

14238 - `status: optional "in_progress" or "completed" or "incomplete"`14282 - `status: optional "in_progress" or "completed" or "incomplete"`

14239 14283 

14240 The status of the item. One of `in_progress`, `completed`, or14284 The status of the item. One of `in_progress`, `completed`, or


17112 Unique identifier for the MCP tool call approval request.17156 Unique identifier for the MCP tool call approval request.

17113 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.17157 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

17114 17158 

17115 - `error: optional string or null`17159 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

17160 

17161 The error from the tool call, if any.

17162 

17163 - `string`

17116 17164 

17117 The error from the tool call, if any.17165 The error from the tool call, if any.

17118 17166 

17167 - `McpProtocolError object { code, message, type }`

17168 

17169 - `code: number`

17170 

17171 - `message: string`

17172 

17173 - `type: "mcp_protocol_error"`

17174 

17175 - `"mcp_protocol_error"`

17176 

17177 - `McpToolExecutionError object { content, type }`

17178 

17179 - `content: unknown`

17180 

17181 - `type: "mcp_tool_execution_error"`

17182 

17183 - `"mcp_tool_execution_error"`

17184 

17185 - `HTTPError object { code, message, type }`

17186 

17187 - `code: number`

17188 

17189 - `message: string`

17190 

17191 - `type: "http_error"`

17192 

17193 - `"http_error"`

17194 

17119 - `output: optional string or null`17195 - `output: optional string or null`

17120 17196 

17121 The output from the tool call.17197 The output from the tool call.


23366 for reasoning items returned by `POST /v1/responses` and WebSocket23442 for reasoning items returned by `POST /v1/responses` and WebSocket

23367 `response.create` requests.23443 `response.create` requests.

23368 23444 

23445 When streaming, use the completed reasoning item and its

23446 `encrypted_content` from the `response.output_item.done` event in

23447 subsequent requests. The `encrypted_content` in

23448 `response.output_item.added` may be incomplete. This is especially

23449 important when `store` is `false` or when using Zero Data Retention.

23450 

23369 - `status: optional "in_progress" or "completed" or "incomplete"`23451 - `status: optional "in_progress" or "completed" or "incomplete"`

23370 23452 

23371 The status of the item. One of `in_progress`, `completed`, or23453 The status of the item. One of `in_progress`, `completed`, or


24139 Unique identifier for the MCP tool call approval request.24221 Unique identifier for the MCP tool call approval request.

24140 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.24222 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

24141 24223 

24142 - `error: optional string or null`24224 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

24225 

24226 The error from the tool call, if any.

24227 

24228 - `string`

24143 24229 

24144 The error from the tool call, if any.24230 The error from the tool call, if any.

24145 24231 

24232 - `McpProtocolError object { code, message, type }`

24233 

24234 - `code: number`

24235 

24236 - `message: string`

24237 

24238 - `type: "mcp_protocol_error"`

24239 

24240 - `"mcp_protocol_error"`

24241 

24242 - `McpToolExecutionError object { content, type }`

24243 

24244 - `content: unknown`

24245 

24246 - `type: "mcp_tool_execution_error"`

24247 

24248 - `"mcp_tool_execution_error"`

24249 

24250 - `HTTPError object { code, message, type }`

24251 

24252 - `code: number`

24253 

24254 - `message: string`

24255 

24256 - `type: "http_error"`

24257 

24258 - `"http_error"`

24259 

24146 - `output: optional string or null`24260 - `output: optional string or null`

24147 24261 

24148 The output from the tool call.24262 The output from the tool call.


28291 for reasoning items returned by `POST /v1/responses` and WebSocket28405 for reasoning items returned by `POST /v1/responses` and WebSocket

28292 `response.create` requests.28406 `response.create` requests.

28293 28407 

28408 When streaming, use the completed reasoning item and its

28409 `encrypted_content` from the `response.output_item.done` event in

28410 subsequent requests. The `encrypted_content` in

28411 `response.output_item.added` may be incomplete. This is especially

28412 important when `store` is `false` or when using Zero Data Retention.

28413 

28294 - `status: optional "in_progress" or "completed" or "incomplete"`28414 - `status: optional "in_progress" or "completed" or "incomplete"`

28295 28415 

28296 The status of the item. One of `in_progress`, `completed`, or28416 The status of the item. One of `in_progress`, `completed`, or


29050 Unique identifier for the MCP tool call approval request.29170 Unique identifier for the MCP tool call approval request.

29051 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.29171 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

29052 29172 

29053 - `error: optional string or null`29173 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

29054 29174 

29055 The error from the tool call, if any.29175 The error from the tool call, if any.

29056 29176 

29177 - `string`

29178 

29179 The error from the tool call, if any.

29180 

29181 - `McpProtocolError object { code, message, type }`

29182 

29183 - `code: number`

29184 

29185 - `message: string`

29186 

29187 - `type: "mcp_protocol_error"`

29188 

29189 - `"mcp_protocol_error"`

29190 

29191 - `McpToolExecutionError object { content, type }`

29192 

29193 - `content: unknown`

29194 

29195 - `type: "mcp_tool_execution_error"`

29196 

29197 - `"mcp_tool_execution_error"`

29198 

29199 - `HTTPError object { code, message, type }`

29200 

29201 - `code: number`

29202 

29203 - `message: string`

29204 

29205 - `type: "http_error"`

29206 

29207 - `"http_error"`

29208 

29057 - `output: optional string or null`29209 - `output: optional string or null`

29058 29210 

29059 The output from the tool call.29211 The output from the tool call.


33225 for reasoning items returned by `POST /v1/responses` and WebSocket33377 for reasoning items returned by `POST /v1/responses` and WebSocket

33226 `response.create` requests.33378 `response.create` requests.

33227 33379 

33380 When streaming, use the completed reasoning item and its

33381 `encrypted_content` from the `response.output_item.done` event in

33382 subsequent requests. The `encrypted_content` in

33383 `response.output_item.added` may be incomplete. This is especially

33384 important when `store` is `false` or when using Zero Data Retention.

33385 

33228 - `status: optional "in_progress" or "completed" or "incomplete"`33386 - `status: optional "in_progress" or "completed" or "incomplete"`

33229 33387 

33230 The status of the item. One of `in_progress`, `completed`, or33388 The status of the item. One of `in_progress`, `completed`, or


33998 Unique identifier for the MCP tool call approval request.34156 Unique identifier for the MCP tool call approval request.

33999 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.34157 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

34000 34158 

34001 - `error: optional string or null`34159 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

34160 

34161 The error from the tool call, if any.

34162 

34163 - `string`

34002 34164 

34003 The error from the tool call, if any.34165 The error from the tool call, if any.

34004 34166 

34167 - `McpProtocolError object { code, message, type }`

34168 

34169 - `code: number`

34170 

34171 - `message: string`

34172 

34173 - `type: "mcp_protocol_error"`

34174 

34175 - `"mcp_protocol_error"`

34176 

34177 - `McpToolExecutionError object { content, type }`

34178 

34179 - `content: unknown`

34180 

34181 - `type: "mcp_tool_execution_error"`

34182 

34183 - `"mcp_tool_execution_error"`

34184 

34185 - `HTTPError object { code, message, type }`

34186 

34187 - `code: number`

34188 

34189 - `message: string`

34190 

34191 - `type: "http_error"`

34192 

34193 - `"http_error"`

34194 

34005 - `output: optional string or null`34195 - `output: optional string or null`

34006 34196 

34007 The output from the tool call.34197 The output from the tool call.


39950 for reasoning items returned by `POST /v1/responses` and WebSocket40140 for reasoning items returned by `POST /v1/responses` and WebSocket

39951 `response.create` requests.40141 `response.create` requests.

39952 40142 

40143 When streaming, use the completed reasoning item and its

40144 `encrypted_content` from the `response.output_item.done` event in

40145 subsequent requests. The `encrypted_content` in

40146 `response.output_item.added` may be incomplete. This is especially

40147 important when `store` is `false` or when using Zero Data Retention.

40148 

39953 - `status: optional "in_progress" or "completed" or "incomplete"`40149 - `status: optional "in_progress" or "completed" or "incomplete"`

39954 40150 

39955 The status of the item. One of `in_progress`, `completed`, or40151 The status of the item. One of `in_progress`, `completed`, or


40723 Unique identifier for the MCP tool call approval request.40919 Unique identifier for the MCP tool call approval request.

40724 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.40920 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

40725 40921 

40726 - `error: optional string or null`40922 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

40923 

40924 The error from the tool call, if any.

40925 

40926 - `string`

40727 40927 

40728 The error from the tool call, if any.40928 The error from the tool call, if any.

40729 40929 

40930 - `McpProtocolError object { code, message, type }`

40931 

40932 - `code: number`

40933 

40934 - `message: string`

40935 

40936 - `type: "mcp_protocol_error"`

40937 

40938 - `"mcp_protocol_error"`

40939 

40940 - `McpToolExecutionError object { content, type }`

40941 

40942 - `content: unknown`

40943 

40944 - `type: "mcp_tool_execution_error"`

40945 

40946 - `"mcp_tool_execution_error"`

40947 

40948 - `HTTPError object { code, message, type }`

40949 

40950 - `code: number`

40951 

40952 - `message: string`

40953 

40954 - `type: "http_error"`

40955 

40956 - `"http_error"`

40957 

40730 - `output: optional string or null`40958 - `output: optional string or null`

40731 40959 

40732 The output from the tool call.40960 The output from the tool call.


42012 for reasoning items returned by `POST /v1/responses` and WebSocket42240 for reasoning items returned by `POST /v1/responses` and WebSocket

42013 `response.create` requests.42241 `response.create` requests.

42014 42242 

42243 When streaming, use the completed reasoning item and its

42244 `encrypted_content` from the `response.output_item.done` event in

42245 subsequent requests. The `encrypted_content` in

42246 `response.output_item.added` may be incomplete. This is especially

42247 important when `store` is `false` or when using Zero Data Retention.

42248 

42015 - `status: optional "in_progress" or "completed" or "incomplete"`42249 - `status: optional "in_progress" or "completed" or "incomplete"`

42016 42250 

42017 The status of the item. One of `in_progress`, `completed`, or42251 The status of the item. One of `in_progress`, `completed`, or


44889 Unique identifier for the MCP tool call approval request.45123 Unique identifier for the MCP tool call approval request.

44890 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.45124 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

44891 45125 

44892 - `error: optional string or null`45126 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

44893 45127 

44894 The error from the tool call, if any.45128 The error from the tool call, if any.

44895 45129 

45130 - `string`

45131 

45132 The error from the tool call, if any.

45133 

45134 - `McpProtocolError object { code, message, type }`

45135 

45136 - `code: number`

45137 

45138 - `message: string`

45139 

45140 - `type: "mcp_protocol_error"`

45141 

45142 - `"mcp_protocol_error"`

45143 

45144 - `McpToolExecutionError object { content, type }`

45145 

45146 - `content: unknown`

45147 

45148 - `type: "mcp_tool_execution_error"`

45149 

45150 - `"mcp_tool_execution_error"`

45151 

45152 - `HTTPError object { code, message, type }`

45153 

45154 - `code: number`

45155 

45156 - `message: string`

45157 

45158 - `type: "http_error"`

45159 

45160 - `"http_error"`

45161 

44896 - `output: optional string or null`45162 - `output: optional string or null`

44897 45163 

44898 The output from the tool call.45164 The output from the tool call.


51806 for reasoning items returned by `POST /v1/responses` and WebSocket52072 for reasoning items returned by `POST /v1/responses` and WebSocket

51807 `response.create` requests.52073 `response.create` requests.

51808 52074 

52075 When streaming, use the completed reasoning item and its

52076 `encrypted_content` from the `response.output_item.done` event in

52077 subsequent requests. The `encrypted_content` in

52078 `response.output_item.added` may be incomplete. This is especially

52079 important when `store` is `false` or when using Zero Data Retention.

52080 

51809 - `status: optional "in_progress" or "completed" or "incomplete"`52081 - `status: optional "in_progress" or "completed" or "incomplete"`

51810 52082 

51811 The status of the item. One of `in_progress`, `completed`, or52083 The status of the item. One of `in_progress`, `completed`, or


52579 Unique identifier for the MCP tool call approval request.52851 Unique identifier for the MCP tool call approval request.

52580 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.52852 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

52581 52853 

52582 - `error: optional string or null`52854 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

52855 

52856 The error from the tool call, if any.

52857 

52858 - `string`

52583 52859 

52584 The error from the tool call, if any.52860 The error from the tool call, if any.

52585 52861 

52862 - `McpProtocolError object { code, message, type }`

52863 

52864 - `code: number`

52865 

52866 - `message: string`

52867 

52868 - `type: "mcp_protocol_error"`

52869 

52870 - `"mcp_protocol_error"`

52871 

52872 - `McpToolExecutionError object { content, type }`

52873 

52874 - `content: unknown`

52875 

52876 - `type: "mcp_tool_execution_error"`

52877 

52878 - `"mcp_tool_execution_error"`

52879 

52880 - `HTTPError object { code, message, type }`

52881 

52882 - `code: number`

52883 

52884 - `message: string`

52885 

52886 - `type: "http_error"`

52887 

52888 - `"http_error"`

52889 

52586 - `output: optional string or null`52890 - `output: optional string or null`

52587 52891 

52588 The output from the tool call.52892 The output from the tool call.


53868 for reasoning items returned by `POST /v1/responses` and WebSocket54172 for reasoning items returned by `POST /v1/responses` and WebSocket

53869 `response.create` requests.54173 `response.create` requests.

53870 54174 

54175 When streaming, use the completed reasoning item and its

54176 `encrypted_content` from the `response.output_item.done` event in

54177 subsequent requests. The `encrypted_content` in

54178 `response.output_item.added` may be incomplete. This is especially

54179 important when `store` is `false` or when using Zero Data Retention.

54180 

53871 - `status: optional "in_progress" or "completed" or "incomplete"`54181 - `status: optional "in_progress" or "completed" or "incomplete"`

53872 54182 

53873 The status of the item. One of `in_progress`, `completed`, or54183 The status of the item. One of `in_progress`, `completed`, or


56745 Unique identifier for the MCP tool call approval request.57055 Unique identifier for the MCP tool call approval request.

56746 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.57056 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

56747 57057 

56748 - `error: optional string or null`57058 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

57059 

57060 The error from the tool call, if any.

57061 

57062 - `string`

56749 57063 

56750 The error from the tool call, if any.57064 The error from the tool call, if any.

56751 57065 

57066 - `McpProtocolError object { code, message, type }`

57067 

57068 - `code: number`

57069 

57070 - `message: string`

57071 

57072 - `type: "mcp_protocol_error"`

57073 

57074 - `"mcp_protocol_error"`

57075 

57076 - `McpToolExecutionError object { content, type }`

57077 

57078 - `content: unknown`

57079 

57080 - `type: "mcp_tool_execution_error"`

57081 

57082 - `"mcp_tool_execution_error"`

57083 

57084 - `HTTPError object { code, message, type }`

57085 

57086 - `code: number`

57087 

57088 - `message: string`

57089 

57090 - `type: "http_error"`

57091 

57092 - `"http_error"`

57093 

56752 - `output: optional string or null`57094 - `output: optional string or null`

56753 57095 

56754 The output from the tool call.57096 The output from the tool call.


62851 for reasoning items returned by `POST /v1/responses` and WebSocket63193 for reasoning items returned by `POST /v1/responses` and WebSocket

62852 `response.create` requests.63194 `response.create` requests.

62853 63195 

63196 When streaming, use the completed reasoning item and its

63197 `encrypted_content` from the `response.output_item.done` event in

63198 subsequent requests. The `encrypted_content` in

63199 `response.output_item.added` may be incomplete. This is especially

63200 important when `store` is `false` or when using Zero Data Retention.

63201 

62854 - `status: optional "in_progress" or "completed" or "incomplete"`63202 - `status: optional "in_progress" or "completed" or "incomplete"`

62855 63203 

62856 The status of the item. One of `in_progress`, `completed`, or63204 The status of the item. One of `in_progress`, `completed`, or


63610 Unique identifier for the MCP tool call approval request.63958 Unique identifier for the MCP tool call approval request.

63611 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.63959 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

63612 63960 

63613 - `error: optional string or null`63961 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

63614 63962 

63615 The error from the tool call, if any.63963 The error from the tool call, if any.

63616 63964 

63965 - `string`

63966 

63967 The error from the tool call, if any.

63968 

63969 - `McpProtocolError object { code, message, type }`

63970 

63971 - `code: number`

63972 

63973 - `message: string`

63974 

63975 - `type: "mcp_protocol_error"`

63976 

63977 - `"mcp_protocol_error"`

63978 

63979 - `McpToolExecutionError object { content, type }`

63980 

63981 - `content: unknown`

63982 

63983 - `type: "mcp_tool_execution_error"`

63984 

63985 - `"mcp_tool_execution_error"`

63986 

63987 - `HTTPError object { code, message, type }`

63988 

63989 - `code: number`

63990 

63991 - `message: string`

63992 

63993 - `type: "http_error"`

63994 

63995 - `"http_error"`

63996 

63617 - `output: optional string or null`63997 - `output: optional string or null`

63618 63998 

63619 The output from the tool call.63999 The output from the tool call.


68500 for reasoning items returned by `POST /v1/responses` and WebSocket68880 for reasoning items returned by `POST /v1/responses` and WebSocket

68501 `response.create` requests.68881 `response.create` requests.

68502 68882 

68883 When streaming, use the completed reasoning item and its

68884 `encrypted_content` from the `response.output_item.done` event in

68885 subsequent requests. The `encrypted_content` in

68886 `response.output_item.added` may be incomplete. This is especially

68887 important when `store` is `false` or when using Zero Data Retention.

68888 

68503 - `status: optional "in_progress" or "completed" or "incomplete"`68889 - `status: optional "in_progress" or "completed" or "incomplete"`

68504 68890 

68505 The status of the item. One of `in_progress`, `completed`, or68891 The status of the item. One of `in_progress`, `completed`, or


69273 Unique identifier for the MCP tool call approval request.69659 Unique identifier for the MCP tool call approval request.

69274 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.69660 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

69275 69661 

69276 - `error: optional string or null`69662 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

69663 

69664 The error from the tool call, if any.

69665 

69666 - `string`

69277 69667 

69278 The error from the tool call, if any.69668 The error from the tool call, if any.

69279 69669 

69670 - `McpProtocolError object { code, message, type }`

69671 

69672 - `code: number`

69673 

69674 - `message: string`

69675 

69676 - `type: "mcp_protocol_error"`

69677 

69678 - `"mcp_protocol_error"`

69679 

69680 - `McpToolExecutionError object { content, type }`

69681 

69682 - `content: unknown`

69683 

69684 - `type: "mcp_tool_execution_error"`

69685 

69686 - `"mcp_tool_execution_error"`

69687 

69688 - `HTTPError object { code, message, type }`

69689 

69690 - `code: number`

69691 

69692 - `message: string`

69693 

69694 - `type: "http_error"`

69695 

69696 - `"http_error"`

69697 

69280 - `output: optional string or null`69698 - `output: optional string or null`

69281 69699 

69282 The output from the tool call.69700 The output from the tool call.


70562 for reasoning items returned by `POST /v1/responses` and WebSocket70980 for reasoning items returned by `POST /v1/responses` and WebSocket

70563 `response.create` requests.70981 `response.create` requests.

70564 70982 

70983 When streaming, use the completed reasoning item and its

70984 `encrypted_content` from the `response.output_item.done` event in

70985 subsequent requests. The `encrypted_content` in

70986 `response.output_item.added` may be incomplete. This is especially

70987 important when `store` is `false` or when using Zero Data Retention.

70988 

70565 - `status: optional "in_progress" or "completed" or "incomplete"`70989 - `status: optional "in_progress" or "completed" or "incomplete"`

70566 70990 

70567 The status of the item. One of `in_progress`, `completed`, or70991 The status of the item. One of `in_progress`, `completed`, or


73439 Unique identifier for the MCP tool call approval request.73863 Unique identifier for the MCP tool call approval request.

73440 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.73864 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

73441 73865 

73442 - `error: optional string or null`73866 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

73867 

73868 The error from the tool call, if any.

73869 

73870 - `string`

73443 73871 

73444 The error from the tool call, if any.73872 The error from the tool call, if any.

73445 73873 

73874 - `McpProtocolError object { code, message, type }`

73875 

73876 - `code: number`

73877 

73878 - `message: string`

73879 

73880 - `type: "mcp_protocol_error"`

73881 

73882 - `"mcp_protocol_error"`

73883 

73884 - `McpToolExecutionError object { content, type }`

73885 

73886 - `content: unknown`

73887 

73888 - `type: "mcp_tool_execution_error"`

73889 

73890 - `"mcp_tool_execution_error"`

73891 

73892 - `HTTPError object { code, message, type }`

73893 

73894 - `code: number`

73895 

73896 - `message: string`

73897 

73898 - `type: "http_error"`

73899 

73900 - `"http_error"`

73901 

73446 - `output: optional string or null`73902 - `output: optional string or null`

73447 73903 

73448 The output from the tool call.73904 The output from the tool call.


79579 for reasoning items returned by `POST /v1/responses` and WebSocket80035 for reasoning items returned by `POST /v1/responses` and WebSocket

79580 `response.create` requests.80036 `response.create` requests.

79581 80037 

80038 When streaming, use the completed reasoning item and its

80039 `encrypted_content` from the `response.output_item.done` event in

80040 subsequent requests. The `encrypted_content` in

80041 `response.output_item.added` may be incomplete. This is especially

80042 important when `store` is `false` or when using Zero Data Retention.

80043 

79582 - `status: optional "in_progress" or "completed" or "incomplete"`80044 - `status: optional "in_progress" or "completed" or "incomplete"`

79583 80045 

79584 The status of the item. One of `in_progress`, `completed`, or80046 The status of the item. One of `in_progress`, `completed`, or


80352 Unique identifier for the MCP tool call approval request.80814 Unique identifier for the MCP tool call approval request.

80353 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.80815 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

80354 80816 

80355 - `error: optional string or null`80817 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

80356 80818 

80357 The error from the tool call, if any.80819 The error from the tool call, if any.

80358 80820 

80821 - `string`

80822 

80823 The error from the tool call, if any.

80824 

80825 - `McpProtocolError object { code, message, type }`

80826 

80827 - `code: number`

80828 

80829 - `message: string`

80830 

80831 - `type: "mcp_protocol_error"`

80832 

80833 - `"mcp_protocol_error"`

80834 

80835 - `McpToolExecutionError object { content, type }`

80836 

80837 - `content: unknown`

80838 

80839 - `type: "mcp_tool_execution_error"`

80840 

80841 - `"mcp_tool_execution_error"`

80842 

80843 - `HTTPError object { code, message, type }`

80844 

80845 - `code: number`

80846 

80847 - `message: string`

80848 

80849 - `type: "http_error"`

80850 

80851 - `"http_error"`

80852 

80359 - `output: optional string or null`80853 - `output: optional string or null`

80360 80854 

80361 The output from the tool call.80855 The output from the tool call.


81641 for reasoning items returned by `POST /v1/responses` and WebSocket82135 for reasoning items returned by `POST /v1/responses` and WebSocket

81642 `response.create` requests.82136 `response.create` requests.

81643 82137 

82138 When streaming, use the completed reasoning item and its

82139 `encrypted_content` from the `response.output_item.done` event in

82140 subsequent requests. The `encrypted_content` in

82141 `response.output_item.added` may be incomplete. This is especially

82142 important when `store` is `false` or when using Zero Data Retention.

82143 

81644 - `status: optional "in_progress" or "completed" or "incomplete"`82144 - `status: optional "in_progress" or "completed" or "incomplete"`

81645 82145 

81646 The status of the item. One of `in_progress`, `completed`, or82146 The status of the item. One of `in_progress`, `completed`, or


84518 Unique identifier for the MCP tool call approval request.85018 Unique identifier for the MCP tool call approval request.

84519 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.85019 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

84520 85020 

84521 - `error: optional string or null`85021 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

85022 

85023 The error from the tool call, if any.

85024 

85025 - `string`

84522 85026 

84523 The error from the tool call, if any.85027 The error from the tool call, if any.

84524 85028 

85029 - `McpProtocolError object { code, message, type }`

85030 

85031 - `code: number`

85032 

85033 - `message: string`

85034 

85035 - `type: "mcp_protocol_error"`

85036 

85037 - `"mcp_protocol_error"`

85038 

85039 - `McpToolExecutionError object { content, type }`

85040 

85041 - `content: unknown`

85042 

85043 - `type: "mcp_tool_execution_error"`

85044 

85045 - `"mcp_tool_execution_error"`

85046 

85047 - `HTTPError object { code, message, type }`

85048 

85049 - `code: number`

85050 

85051 - `message: string`

85052 

85053 - `type: "http_error"`

85054 

85055 - `"http_error"`

85056 

84525 - `output: optional string or null`85057 - `output: optional string or null`

84526 85058 

84527 The output from the tool call.85059 The output from the tool call.


91119 for reasoning items returned by `POST /v1/responses` and WebSocket91651 for reasoning items returned by `POST /v1/responses` and WebSocket

91120 `response.create` requests.91652 `response.create` requests.

91121 91653 

91654 When streaming, use the completed reasoning item and its

91655 `encrypted_content` from the `response.output_item.done` event in

91656 subsequent requests. The `encrypted_content` in

91657 `response.output_item.added` may be incomplete. This is especially

91658 important when `store` is `false` or when using Zero Data Retention.

91659 

91122 - `status: optional "in_progress" or "completed" or "incomplete"`91660 - `status: optional "in_progress" or "completed" or "incomplete"`

91123 91661 

91124 The status of the item. One of `in_progress`, `completed`, or91662 The status of the item. One of `in_progress`, `completed`, or


91892 Unique identifier for the MCP tool call approval request.92430 Unique identifier for the MCP tool call approval request.

91893 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.92431 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

91894 92432 

91895 - `error: optional string or null`92433 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

92434 

92435 The error from the tool call, if any.

92436 

92437 - `string`

91896 92438 

91897 The error from the tool call, if any.92439 The error from the tool call, if any.

91898 92440 

92441 - `McpProtocolError object { code, message, type }`

92442 

92443 - `code: number`

92444 

92445 - `message: string`

92446 

92447 - `type: "mcp_protocol_error"`

92448 

92449 - `"mcp_protocol_error"`

92450 

92451 - `McpToolExecutionError object { content, type }`

92452 

92453 - `content: unknown`

92454 

92455 - `type: "mcp_tool_execution_error"`

92456 

92457 - `"mcp_tool_execution_error"`

92458 

92459 - `HTTPError object { code, message, type }`

92460 

92461 - `code: number`

92462 

92463 - `message: string`

92464 

92465 - `type: "http_error"`

92466 

92467 - `"http_error"`

92468 

91899 - `output: optional string or null`92469 - `output: optional string or null`

91900 92470 

91901 The output from the tool call.92471 The output from the tool call.


93181 for reasoning items returned by `POST /v1/responses` and WebSocket93751 for reasoning items returned by `POST /v1/responses` and WebSocket

93182 `response.create` requests.93752 `response.create` requests.

93183 93753 

93754 When streaming, use the completed reasoning item and its

93755 `encrypted_content` from the `response.output_item.done` event in

93756 subsequent requests. The `encrypted_content` in

93757 `response.output_item.added` may be incomplete. This is especially

93758 important when `store` is `false` or when using Zero Data Retention.

93759 

93184 - `status: optional "in_progress" or "completed" or "incomplete"`93760 - `status: optional "in_progress" or "completed" or "incomplete"`

93185 93761 

93186 The status of the item. One of `in_progress`, `completed`, or93762 The status of the item. One of `in_progress`, `completed`, or


96058 Unique identifier for the MCP tool call approval request.96634 Unique identifier for the MCP tool call approval request.

96059 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.96635 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

96060 96636 

96061 - `error: optional string or null`96637 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

96062 96638 

96063 The error from the tool call, if any.96639 The error from the tool call, if any.

96064 96640 

96641 - `string`

96642 

96643 The error from the tool call, if any.

96644 

96645 - `McpProtocolError object { code, message, type }`

96646 

96647 - `code: number`

96648 

96649 - `message: string`

96650 

96651 - `type: "mcp_protocol_error"`

96652 

96653 - `"mcp_protocol_error"`

96654 

96655 - `McpToolExecutionError object { content, type }`

96656 

96657 - `content: unknown`

96658 

96659 - `type: "mcp_tool_execution_error"`

96660 

96661 - `"mcp_tool_execution_error"`

96662 

96663 - `HTTPError object { code, message, type }`

96664 

96665 - `code: number`

96666 

96667 - `message: string`

96668 

96669 - `type: "http_error"`

96670 

96671 - `"http_error"`

96672 

96065 - `output: optional string or null`96673 - `output: optional string or null`

96066 96674 

96067 The output from the tool call.96675 The output from the tool call.


102106 for reasoning items returned by `POST /v1/responses` and WebSocket102714 for reasoning items returned by `POST /v1/responses` and WebSocket

102107 `response.create` requests.102715 `response.create` requests.

102108 102716 

102717 When streaming, use the completed reasoning item and its

102718 `encrypted_content` from the `response.output_item.done` event in

102719 subsequent requests. The `encrypted_content` in

102720 `response.output_item.added` may be incomplete. This is especially

102721 important when `store` is `false` or when using Zero Data Retention.

102722 

102109 - `status: optional "in_progress" or "completed" or "incomplete"`102723 - `status: optional "in_progress" or "completed" or "incomplete"`

102110 102724 

102111 The status of the item. One of `in_progress`, `completed`, or102725 The status of the item. One of `in_progress`, `completed`, or


102879 Unique identifier for the MCP tool call approval request.103493 Unique identifier for the MCP tool call approval request.

102880 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.103494 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

102881 103495 

102882 - `error: optional string or null`103496 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

103497 

103498 The error from the tool call, if any.

103499 

103500 - `string`

102883 103501 

102884 The error from the tool call, if any.103502 The error from the tool call, if any.

102885 103503 

103504 - `McpProtocolError object { code, message, type }`

103505 

103506 - `code: number`

103507 

103508 - `message: string`

103509 

103510 - `type: "mcp_protocol_error"`

103511 

103512 - `"mcp_protocol_error"`

103513 

103514 - `McpToolExecutionError object { content, type }`

103515 

103516 - `content: unknown`

103517 

103518 - `type: "mcp_tool_execution_error"`

103519 

103520 - `"mcp_tool_execution_error"`

103521 

103522 - `HTTPError object { code, message, type }`

103523 

103524 - `code: number`

103525 

103526 - `message: string`

103527 

103528 - `type: "http_error"`

103529 

103530 - `"http_error"`

103531 

102886 - `output: optional string or null`103532 - `output: optional string or null`

102887 103533 

102888 The output from the tool call.103534 The output from the tool call.


104168 for reasoning items returned by `POST /v1/responses` and WebSocket104814 for reasoning items returned by `POST /v1/responses` and WebSocket

104169 `response.create` requests.104815 `response.create` requests.

104170 104816 

104817 When streaming, use the completed reasoning item and its

104818 `encrypted_content` from the `response.output_item.done` event in

104819 subsequent requests. The `encrypted_content` in

104820 `response.output_item.added` may be incomplete. This is especially

104821 important when `store` is `false` or when using Zero Data Retention.

104822 

104171 - `status: optional "in_progress" or "completed" or "incomplete"`104823 - `status: optional "in_progress" or "completed" or "incomplete"`

104172 104824 

104173 The status of the item. One of `in_progress`, `completed`, or104825 The status of the item. One of `in_progress`, `completed`, or


107045 Unique identifier for the MCP tool call approval request.107697 Unique identifier for the MCP tool call approval request.

107046 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.107698 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

107047 107699 

107048 - `error: optional string or null`107700 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

107701 

107702 The error from the tool call, if any.

107703 

107704 - `string`

107049 107705 

107050 The error from the tool call, if any.107706 The error from the tool call, if any.

107051 107707 

107708 - `McpProtocolError object { code, message, type }`

107709 

107710 - `code: number`

107711 

107712 - `message: string`

107713 

107714 - `type: "mcp_protocol_error"`

107715 

107716 - `"mcp_protocol_error"`

107717 

107718 - `McpToolExecutionError object { content, type }`

107719 

107720 - `content: unknown`

107721 

107722 - `type: "mcp_tool_execution_error"`

107723 

107724 - `"mcp_tool_execution_error"`

107725 

107726 - `HTTPError object { code, message, type }`

107727 

107728 - `code: number`

107729 

107730 - `message: string`

107731 

107732 - `type: "http_error"`

107733 

107734 - `"http_error"`

107735 

107052 - `output: optional string or null`107736 - `output: optional string or null`

107053 107737 

107054 The output from the tool call.107738 The output from the tool call.


113390 for reasoning items returned by `POST /v1/responses` and WebSocket114074 for reasoning items returned by `POST /v1/responses` and WebSocket

113391 `response.create` requests.114075 `response.create` requests.

113392 114076 

114077 When streaming, use the completed reasoning item and its

114078 `encrypted_content` from the `response.output_item.done` event in

114079 subsequent requests. The `encrypted_content` in

114080 `response.output_item.added` may be incomplete. This is especially

114081 important when `store` is `false` or when using Zero Data Retention.

114082 

113393 - `status: optional "in_progress" or "completed" or "incomplete"`114083 - `status: optional "in_progress" or "completed" or "incomplete"`

113394 114084 

113395 The status of the item. One of `in_progress`, `completed`, or114085 The status of the item. One of `in_progress`, `completed`, or


114163 Unique identifier for the MCP tool call approval request.114853 Unique identifier for the MCP tool call approval request.

114164 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.114854 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

114165 114855 

114166 - `error: optional string or null`114856 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

114167 114857 

114168 The error from the tool call, if any.114858 The error from the tool call, if any.

114169 114859 

114860 - `string`

114861 

114862 The error from the tool call, if any.

114863 

114864 - `McpProtocolError object { code, message, type }`

114865 

114866 - `code: number`

114867 

114868 - `message: string`

114869 

114870 - `type: "mcp_protocol_error"`

114871 

114872 - `"mcp_protocol_error"`

114873 

114874 - `McpToolExecutionError object { content, type }`

114875 

114876 - `content: unknown`

114877 

114878 - `type: "mcp_tool_execution_error"`

114879 

114880 - `"mcp_tool_execution_error"`

114881 

114882 - `HTTPError object { code, message, type }`

114883 

114884 - `code: number`

114885 

114886 - `message: string`

114887 

114888 - `type: "http_error"`

114889 

114890 - `"http_error"`

114891 

114170 - `output: optional string or null`114892 - `output: optional string or null`

114171 114893 

114172 The output from the tool call.114894 The output from the tool call.


115452 for reasoning items returned by `POST /v1/responses` and WebSocket116174 for reasoning items returned by `POST /v1/responses` and WebSocket

115453 `response.create` requests.116175 `response.create` requests.

115454 116176 

116177 When streaming, use the completed reasoning item and its

116178 `encrypted_content` from the `response.output_item.done` event in

116179 subsequent requests. The `encrypted_content` in

116180 `response.output_item.added` may be incomplete. This is especially

116181 important when `store` is `false` or when using Zero Data Retention.

116182 

115455 - `status: optional "in_progress" or "completed" or "incomplete"`116183 - `status: optional "in_progress" or "completed" or "incomplete"`

115456 116184 

115457 The status of the item. One of `in_progress`, `completed`, or116185 The status of the item. One of `in_progress`, `completed`, or


118329 Unique identifier for the MCP tool call approval request.119057 Unique identifier for the MCP tool call approval request.

118330 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.119058 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

118331 119059 

118332 - `error: optional string or null`119060 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

119061 

119062 The error from the tool call, if any.

119063 

119064 - `string`

118333 119065 

118334 The error from the tool call, if any.119066 The error from the tool call, if any.

118335 119067 

119068 - `McpProtocolError object { code, message, type }`

119069 

119070 - `code: number`

119071 

119072 - `message: string`

119073 

119074 - `type: "mcp_protocol_error"`

119075 

119076 - `"mcp_protocol_error"`

119077 

119078 - `McpToolExecutionError object { content, type }`

119079 

119080 - `content: unknown`

119081 

119082 - `type: "mcp_tool_execution_error"`

119083 

119084 - `"mcp_tool_execution_error"`

119085 

119086 - `HTTPError object { code, message, type }`

119087 

119088 - `code: number`

119089 

119090 - `message: string`

119091 

119092 - `type: "http_error"`

119093 

119094 - `"http_error"`

119095 

118336 - `output: optional string or null`119096 - `output: optional string or null`

118337 119097 

118338 The output from the tool call.119098 The output from the tool call.


124246 for reasoning items returned by `POST /v1/responses` and WebSocket125006 for reasoning items returned by `POST /v1/responses` and WebSocket

124247 `response.create` requests.125007 `response.create` requests.

124248 125008 

125009 When streaming, use the completed reasoning item and its

125010 `encrypted_content` from the `response.output_item.done` event in

125011 subsequent requests. The `encrypted_content` in

125012 `response.output_item.added` may be incomplete. This is especially

125013 important when `store` is `false` or when using Zero Data Retention.

125014 

124249 - `status: optional "in_progress" or "completed" or "incomplete"`125015 - `status: optional "in_progress" or "completed" or "incomplete"`

124250 125016 

124251 The status of the item. One of `in_progress`, `completed`, or125017 The status of the item. One of `in_progress`, `completed`, or


125019 Unique identifier for the MCP tool call approval request.125785 Unique identifier for the MCP tool call approval request.

125020 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.125786 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

125021 125787 

125022 - `error: optional string or null`125788 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

125789 

125790 The error from the tool call, if any.

125791 

125792 - `string`

125023 125793 

125024 The error from the tool call, if any.125794 The error from the tool call, if any.

125025 125795 

125796 - `McpProtocolError object { code, message, type }`

125797 

125798 - `code: number`

125799 

125800 - `message: string`

125801 

125802 - `type: "mcp_protocol_error"`

125803 

125804 - `"mcp_protocol_error"`

125805 

125806 - `McpToolExecutionError object { content, type }`

125807 

125808 - `content: unknown`

125809 

125810 - `type: "mcp_tool_execution_error"`

125811 

125812 - `"mcp_tool_execution_error"`

125813 

125814 - `HTTPError object { code, message, type }`

125815 

125816 - `code: number`

125817 

125818 - `message: string`

125819 

125820 - `type: "http_error"`

125821 

125822 - `"http_error"`

125823 

125026 - `output: optional string or null`125824 - `output: optional string or null`

125027 125825 

125028 The output from the tool call.125826 The output from the tool call.


126308 for reasoning items returned by `POST /v1/responses` and WebSocket127106 for reasoning items returned by `POST /v1/responses` and WebSocket

126309 `response.create` requests.127107 `response.create` requests.

126310 127108 

127109 When streaming, use the completed reasoning item and its

127110 `encrypted_content` from the `response.output_item.done` event in

127111 subsequent requests. The `encrypted_content` in

127112 `response.output_item.added` may be incomplete. This is especially

127113 important when `store` is `false` or when using Zero Data Retention.

127114 

126311 - `status: optional "in_progress" or "completed" or "incomplete"`127115 - `status: optional "in_progress" or "completed" or "incomplete"`

126312 127116 

126313 The status of the item. One of `in_progress`, `completed`, or127117 The status of the item. One of `in_progress`, `completed`, or


129185 Unique identifier for the MCP tool call approval request.129989 Unique identifier for the MCP tool call approval request.

129186 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.129990 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

129187 129991 

129188 - `error: optional string or null`129992 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

129189 129993 

129190 The error from the tool call, if any.129994 The error from the tool call, if any.

129191 129995 

129996 - `string`

129997 

129998 The error from the tool call, if any.

129999 

130000 - `McpProtocolError object { code, message, type }`

130001 

130002 - `code: number`

130003 

130004 - `message: string`

130005 

130006 - `type: "mcp_protocol_error"`

130007 

130008 - `"mcp_protocol_error"`

130009 

130010 - `McpToolExecutionError object { content, type }`

130011 

130012 - `content: unknown`

130013 

130014 - `type: "mcp_tool_execution_error"`

130015 

130016 - `"mcp_tool_execution_error"`

130017 

130018 - `HTTPError object { code, message, type }`

130019 

130020 - `code: number`

130021 

130022 - `message: string`

130023 

130024 - `type: "http_error"`

130025 

130026 - `"http_error"`

130027 

129192 - `output: optional string or null`130028 - `output: optional string or null`

129193 130029 

129194 The output from the tool call.130030 The output from the tool call.


135009 for reasoning items returned by `POST /v1/responses` and WebSocket135845 for reasoning items returned by `POST /v1/responses` and WebSocket

135010 `response.create` requests.135846 `response.create` requests.

135011 135847 

135848 When streaming, use the completed reasoning item and its

135849 `encrypted_content` from the `response.output_item.done` event in

135850 subsequent requests. The `encrypted_content` in

135851 `response.output_item.added` may be incomplete. This is especially

135852 important when `store` is `false` or when using Zero Data Retention.

135853 

135012 - `status: optional "in_progress" or "completed" or "incomplete"`135854 - `status: optional "in_progress" or "completed" or "incomplete"`

135013 135855 

135014 The status of the item. One of `in_progress`, `completed`, or135856 The status of the item. One of `in_progress`, `completed`, or


135782 Unique identifier for the MCP tool call approval request.136624 Unique identifier for the MCP tool call approval request.

135783 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.136625 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

135784 136626 

135785 - `error: optional string or null`136627 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

136628 

136629 The error from the tool call, if any.

136630 

136631 - `string`

135786 136632 

135787 The error from the tool call, if any.136633 The error from the tool call, if any.

135788 136634 

136635 - `McpProtocolError object { code, message, type }`

136636 

136637 - `code: number`

136638 

136639 - `message: string`

136640 

136641 - `type: "mcp_protocol_error"`

136642 

136643 - `"mcp_protocol_error"`

136644 

136645 - `McpToolExecutionError object { content, type }`

136646 

136647 - `content: unknown`

136648 

136649 - `type: "mcp_tool_execution_error"`

136650 

136651 - `"mcp_tool_execution_error"`

136652 

136653 - `HTTPError object { code, message, type }`

136654 

136655 - `code: number`

136656 

136657 - `message: string`

136658 

136659 - `type: "http_error"`

136660 

136661 - `"http_error"`

136662 

135789 - `output: optional string or null`136663 - `output: optional string or null`

135790 136664 

135791 The output from the tool call.136665 The output from the tool call.


139835 for reasoning items returned by `POST /v1/responses` and WebSocket140709 for reasoning items returned by `POST /v1/responses` and WebSocket

139836 `response.create` requests.140710 `response.create` requests.

139837 140711 

140712 When streaming, use the completed reasoning item and its

140713 `encrypted_content` from the `response.output_item.done` event in

140714 subsequent requests. The `encrypted_content` in

140715 `response.output_item.added` may be incomplete. This is especially

140716 important when `store` is `false` or when using Zero Data Retention.

140717 

139838 - `status: optional "in_progress" or "completed" or "incomplete"`140718 - `status: optional "in_progress" or "completed" or "incomplete"`

139839 140719 

139840 The status of the item. One of `in_progress`, `completed`, or140720 The status of the item. One of `in_progress`, `completed`, or


140608 Unique identifier for the MCP tool call approval request.141488 Unique identifier for the MCP tool call approval request.

140609 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.141489 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

140610 141490 

140611 - `error: optional string or null`141491 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

141492 

141493 The error from the tool call, if any.

141494 

141495 - `string`

140612 141496 

140613 The error from the tool call, if any.141497 The error from the tool call, if any.

140614 141498 

141499 - `McpProtocolError object { code, message, type }`

141500 

141501 - `code: number`

141502 

141503 - `message: string`

141504 

141505 - `type: "mcp_protocol_error"`

141506 

141507 - `"mcp_protocol_error"`

141508 

141509 - `McpToolExecutionError object { content, type }`

141510 

141511 - `content: unknown`

141512 

141513 - `type: "mcp_tool_execution_error"`

141514 

141515 - `"mcp_tool_execution_error"`

141516 

141517 - `HTTPError object { code, message, type }`

141518 

141519 - `code: number`

141520 

141521 - `message: string`

141522 

141523 - `type: "http_error"`

141524 

141525 - `"http_error"`

141526 

140615 - `output: optional string or null`141527 - `output: optional string or null`

140616 141528 

140617 The output from the tool call.141529 The output from the tool call.


143155 for reasoning items returned by `POST /v1/responses` and WebSocket144067 for reasoning items returned by `POST /v1/responses` and WebSocket

143156 `response.create` requests.144068 `response.create` requests.

143157 144069 

144070 When streaming, use the completed reasoning item and its

144071 `encrypted_content` from the `response.output_item.done` event in

144072 subsequent requests. The `encrypted_content` in

144073 `response.output_item.added` may be incomplete. This is especially

144074 important when `store` is `false` or when using Zero Data Retention.

144075 

143158 - `status: optional "in_progress" or "completed" or "incomplete"`144076 - `status: optional "in_progress" or "completed" or "incomplete"`

143159 144077 

143160 The status of the item. One of `in_progress`, `completed`, or144078 The status of the item. One of `in_progress`, `completed`, or


146182 Unique identifier for the MCP tool call approval request.147100 Unique identifier for the MCP tool call approval request.

146183 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.147101 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

146184 147102 

146185 - `error: optional string or null`147103 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

146186 147104 

146187 The error from the tool call, if any.147105 The error from the tool call, if any.

146188 147106 

147107 - `string`

147108 

147109 The error from the tool call, if any.

147110 

147111 - `McpProtocolError object { code, message, type }`

147112 

147113 - `code: number`

147114 

147115 - `message: string`

147116 

147117 - `type: "mcp_protocol_error"`

147118 

147119 - `"mcp_protocol_error"`

147120 

147121 - `McpToolExecutionError object { content, type }`

147122 

147123 - `content: unknown`

147124 

147125 - `type: "mcp_tool_execution_error"`

147126 

147127 - `"mcp_tool_execution_error"`

147128 

147129 - `HTTPError object { code, message, type }`

147130 

147131 - `code: number`

147132 

147133 - `message: string`

147134 

147135 - `type: "http_error"`

147136 

147137 - `"http_error"`

147138 

146189 - `output: optional string or null`147139 - `output: optional string or null`

146190 147140 

146191 The output from the tool call.147141 The output from the tool call.


146476 147426 

146477 - `item: BetaResponseOutputItem`147427 - `item: BetaResponseOutputItem`

146478 147428 

146479 The output item that was added.147429 The output item that was added. For reasoning items, `encrypted_content`

147430 may be incomplete while the item is in progress. Use the reasoning item

147431 from the corresponding `response.output_item.done` event when passing it

147432 as input to a subsequent request.

146480 147433 

146481 - `BetaResponseOutputMessage object { id, content, role, 4 more }`147434 - `BetaResponseOutputMessage object { id, content, role, 4 more }`

146482 147435 


147791 for reasoning items returned by `POST /v1/responses` and WebSocket148744 for reasoning items returned by `POST /v1/responses` and WebSocket

147792 `response.create` requests.148745 `response.create` requests.

147793 148746 

148747 When streaming, use the completed reasoning item and its

148748 `encrypted_content` from the `response.output_item.done` event in

148749 subsequent requests. The `encrypted_content` in

148750 `response.output_item.added` may be incomplete. This is especially

148751 important when `store` is `false` or when using Zero Data Retention.

148752 

147794 - `status: optional "in_progress" or "completed" or "incomplete"`148753 - `status: optional "in_progress" or "completed" or "incomplete"`

147795 148754 

147796 The status of the item. One of `in_progress`, `completed`, or148755 The status of the item. One of `in_progress`, `completed`, or


150818 Unique identifier for the MCP tool call approval request.151777 Unique identifier for the MCP tool call approval request.

150819 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.151778 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

150820 151779 

150821 - `error: optional string or null`151780 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

151781 

151782 The error from the tool call, if any.

151783 

151784 - `string`

150822 151785 

150823 The error from the tool call, if any.151786 The error from the tool call, if any.

150824 151787 

151788 - `McpProtocolError object { code, message, type }`

151789 

151790 - `code: number`

151791 

151792 - `message: string`

151793 

151794 - `type: "mcp_protocol_error"`

151795 

151796 - `"mcp_protocol_error"`

151797 

151798 - `McpToolExecutionError object { content, type }`

151799 

151800 - `content: unknown`

151801 

151802 - `type: "mcp_tool_execution_error"`

151803 

151804 - `"mcp_tool_execution_error"`

151805 

151806 - `HTTPError object { code, message, type }`

151807 

151808 - `code: number`

151809 

151810 - `message: string`

151811 

151812 - `type: "http_error"`

151813 

151814 - `"http_error"`

151815 

150825 - `output: optional string or null`151816 - `output: optional string or null`

150826 151817 

150827 The output from the tool call.151818 The output from the tool call.


152449 for reasoning items returned by `POST /v1/responses` and WebSocket153440 for reasoning items returned by `POST /v1/responses` and WebSocket

152450 `response.create` requests.153441 `response.create` requests.

152451 153442 

153443 When streaming, use the completed reasoning item and its

153444 `encrypted_content` from the `response.output_item.done` event in

153445 subsequent requests. The `encrypted_content` in

153446 `response.output_item.added` may be incomplete. This is especially

153447 important when `store` is `false` or when using Zero Data Retention.

153448 

152452 - `status: optional "in_progress" or "completed" or "incomplete"`153449 - `status: optional "in_progress" or "completed" or "incomplete"`

152453 153450 

152454 The status of the item. One of `in_progress`, `completed`, or153451 The status of the item. One of `in_progress`, `completed`, or


155476 Unique identifier for the MCP tool call approval request.156473 Unique identifier for the MCP tool call approval request.

155477 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.156474 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

155478 156475 

155479 - `error: optional string or null`156476 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

156477 

156478 The error from the tool call, if any.

156479 

156480 - `string`

155480 156481 

155481 The error from the tool call, if any.156482 The error from the tool call, if any.

155482 156483 

156484 - `McpProtocolError object { code, message, type }`

156485 

156486 - `code: number`

156487 

156488 - `message: string`

156489 

156490 - `type: "mcp_protocol_error"`

156491 

156492 - `"mcp_protocol_error"`

156493 

156494 - `McpToolExecutionError object { content, type }`

156495 

156496 - `content: unknown`

156497 

156498 - `type: "mcp_tool_execution_error"`

156499 

156500 - `"mcp_tool_execution_error"`

156501 

156502 - `HTTPError object { code, message, type }`

156503 

156504 - `code: number`

156505 

156506 - `message: string`

156507 

156508 - `type: "http_error"`

156509 

156510 - `"http_error"`

156511 

155483 - `output: optional string or null`156512 - `output: optional string or null`

155484 156513 

155485 The output from the tool call.156514 The output from the tool call.


156137 157166 

156138 Emitted when an annotation is added to output text content.157167 Emitted when an annotation is added to output text content.

156139 157168 

156140 - `annotation: unknown`157169 - `annotation: object { file_id, filename, index, type } or object { end_index, start_index, title, 2 more } or object { container_id, end_index, file_id, 3 more } or object { file_id, index, type } or null`

156141 157170 

156142 The annotation object being added. (See annotation schema for details.)157171 An annotation that applies to a span of output text.

157172 

157173 - `FileCitation object { file_id, filename, index, type }`

157174 

157175 A citation to a file.

157176 

157177 - `file_id: string`

157178 

157179 The ID of the file.

157180 

157181 - `filename: string`

157182 

157183 The filename of the file cited.

157184 

157185 - `index: number`

157186 

157187 The index of the file in the list of files.

157188 

157189 - `type: "file_citation"`

157190 

157191 The type of the file citation. Always `file_citation`.

157192 

157193 - `"file_citation"`

157194 

157195 - `URLCitation object { end_index, start_index, title, 2 more }`

157196 

157197 A citation for a web resource used to generate a model response.

157198 

157199 - `end_index: number`

157200 

157201 The index of the last character of the URL citation in the message.

157202 

157203 - `start_index: number`

157204 

157205 The index of the first character of the URL citation in the message.

157206 

157207 - `title: string`

157208 

157209 The title of the web resource.

157210 

157211 - `type: "url_citation"`

157212 

157213 The type of the URL citation. Always `url_citation`.

157214 

157215 - `"url_citation"`

157216 

157217 - `url: string`

157218 

157219 The URL of the web resource.

157220 

157221 - `ContainerFileCitation object { container_id, end_index, file_id, 3 more }`

157222 

157223 A citation for a container file used to generate a model response.

157224 

157225 - `container_id: string`

157226 

157227 The ID of the container file.

157228 

157229 - `end_index: number`

157230 

157231 The index of the last character of the container file citation in the message.

157232 

157233 - `file_id: string`

157234 

157235 The ID of the file.

157236 

157237 - `filename: string`

157238 

157239 The filename of the container file cited.

157240 

157241 - `start_index: number`

157242 

157243 The index of the first character of the container file citation in the message.

157244 

157245 - `type: "container_file_citation"`

157246 

157247 The type of the container file citation. Always `container_file_citation`.

157248 

157249 - `"container_file_citation"`

157250 

157251 - `FilePath object { file_id, index, type }`

157252 

157253 A path to a file.

157254 

157255 - `file_id: string`

157256 

157257 The ID of the file.

157258 

157259 - `index: number`

157260 

157261 The index of the file in the list of files.

157262 

157263 - `type: "file_path"`

157264 

157265 The type of the file path. Always `file_path`.

157266 

157267 - `"file_path"`

156143 157268 

156144 - `annotation_index: number`157269 - `annotation_index: number`

156145 157270 


160160 for reasoning items returned by `POST /v1/responses` and WebSocket161285 for reasoning items returned by `POST /v1/responses` and WebSocket

160161 `response.create` requests.161286 `response.create` requests.

160162 161287 

161288 When streaming, use the completed reasoning item and its

161289 `encrypted_content` from the `response.output_item.done` event in

161290 subsequent requests. The `encrypted_content` in

161291 `response.output_item.added` may be incomplete. This is especially

161292 important when `store` is `false` or when using Zero Data Retention.

161293 

160163 - `status: optional "in_progress" or "completed" or "incomplete"`161294 - `status: optional "in_progress" or "completed" or "incomplete"`

160164 161295 

160165 The status of the item. One of `in_progress`, `completed`, or161296 The status of the item. One of `in_progress`, `completed`, or


160933 Unique identifier for the MCP tool call approval request.162064 Unique identifier for the MCP tool call approval request.

160934 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.162065 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

160935 162066 

160936 - `error: optional string or null`162067 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

162068 

162069 The error from the tool call, if any.

162070 

162071 - `string`

160937 162072 

160938 The error from the tool call, if any.162073 The error from the tool call, if any.

160939 162074 

162075 - `McpProtocolError object { code, message, type }`

162076 

162077 - `code: number`

162078 

162079 - `message: string`

162080 

162081 - `type: "mcp_protocol_error"`

162082 

162083 - `"mcp_protocol_error"`

162084 

162085 - `McpToolExecutionError object { content, type }`

162086 

162087 - `content: unknown`

162088 

162089 - `type: "mcp_tool_execution_error"`

162090 

162091 - `"mcp_tool_execution_error"`

162092 

162093 - `HTTPError object { code, message, type }`

162094 

162095 - `code: number`

162096 

162097 - `message: string`

162098 

162099 - `type: "http_error"`

162100 

162101 - `"http_error"`

162102 

160940 - `output: optional string or null`162103 - `output: optional string or null`

160941 162104 

160942 The output from the tool call.162105 The output from the tool call.


162222 for reasoning items returned by `POST /v1/responses` and WebSocket163385 for reasoning items returned by `POST /v1/responses` and WebSocket

162223 `response.create` requests.163386 `response.create` requests.

162224 163387 

163388 When streaming, use the completed reasoning item and its

163389 `encrypted_content` from the `response.output_item.done` event in

163390 subsequent requests. The `encrypted_content` in

163391 `response.output_item.added` may be incomplete. This is especially

163392 important when `store` is `false` or when using Zero Data Retention.

163393 

162225 - `status: optional "in_progress" or "completed" or "incomplete"`163394 - `status: optional "in_progress" or "completed" or "incomplete"`

162226 163395 

162227 The status of the item. One of `in_progress`, `completed`, or163396 The status of the item. One of `in_progress`, `completed`, or


165099 Unique identifier for the MCP tool call approval request.166268 Unique identifier for the MCP tool call approval request.

165100 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.166269 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

165101 166270 

165102 - `error: optional string or null`166271 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

166272 

166273 The error from the tool call, if any.

166274 

166275 - `string`

165103 166276 

165104 The error from the tool call, if any.166277 The error from the tool call, if any.

165105 166278 

166279 - `McpProtocolError object { code, message, type }`

166280 

166281 - `code: number`

166282 

166283 - `message: string`

166284 

166285 - `type: "mcp_protocol_error"`

166286 

166287 - `"mcp_protocol_error"`

166288 

166289 - `McpToolExecutionError object { content, type }`

166290 

166291 - `content: unknown`

166292 

166293 - `type: "mcp_tool_execution_error"`

166294 

166295 - `"mcp_tool_execution_error"`

166296 

166297 - `HTTPError object { code, message, type }`

166298 

166299 - `code: number`

166300 

166301 - `message: string`

166302 

166303 - `type: "http_error"`

166304 

166305 - `"http_error"`

166306 

165106 - `output: optional string or null`166307 - `output: optional string or null`

165107 166308 

165108 The output from the tool call.166309 The output from the tool call.


171609 for reasoning items returned by `POST /v1/responses` and WebSocket172810 for reasoning items returned by `POST /v1/responses` and WebSocket

171610 `response.create` requests.172811 `response.create` requests.

171611 172812 

172813 When streaming, use the completed reasoning item and its

172814 `encrypted_content` from the `response.output_item.done` event in

172815 subsequent requests. The `encrypted_content` in

172816 `response.output_item.added` may be incomplete. This is especially

172817 important when `store` is `false` or when using Zero Data Retention.

172818 

171612 - `status: optional "in_progress" or "completed" or "incomplete"`172819 - `status: optional "in_progress" or "completed" or "incomplete"`

171613 172820 

171614 The status of the item. One of `in_progress`, `completed`, or172821 The status of the item. One of `in_progress`, `completed`, or


172382 Unique identifier for the MCP tool call approval request.173589 Unique identifier for the MCP tool call approval request.

172383 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.173590 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

172384 173591 

172385 - `error: optional string or null`173592 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

173593 

173594 The error from the tool call, if any.

173595 

173596 - `string`

172386 173597 

172387 The error from the tool call, if any.173598 The error from the tool call, if any.

172388 173599 

173600 - `McpProtocolError object { code, message, type }`

173601 

173602 - `code: number`

173603 

173604 - `message: string`

173605 

173606 - `type: "mcp_protocol_error"`

173607 

173608 - `"mcp_protocol_error"`

173609 

173610 - `McpToolExecutionError object { content, type }`

173611 

173612 - `content: unknown`

173613 

173614 - `type: "mcp_tool_execution_error"`

173615 

173616 - `"mcp_tool_execution_error"`

173617 

173618 - `HTTPError object { code, message, type }`

173619 

173620 - `code: number`

173621 

173622 - `message: string`

173623 

173624 - `type: "http_error"`

173625 

173626 - `"http_error"`

173627 

172389 - `output: optional string or null`173628 - `output: optional string or null`

172390 173629 

172391 The output from the tool call.173630 The output from the tool call.


173671 for reasoning items returned by `POST /v1/responses` and WebSocket174910 for reasoning items returned by `POST /v1/responses` and WebSocket

173672 `response.create` requests.174911 `response.create` requests.

173673 174912 

174913 When streaming, use the completed reasoning item and its

174914 `encrypted_content` from the `response.output_item.done` event in

174915 subsequent requests. The `encrypted_content` in

174916 `response.output_item.added` may be incomplete. This is especially

174917 important when `store` is `false` or when using Zero Data Retention.

174918 

173674 - `status: optional "in_progress" or "completed" or "incomplete"`174919 - `status: optional "in_progress" or "completed" or "incomplete"`

173675 174920 

173676 The status of the item. One of `in_progress`, `completed`, or174921 The status of the item. One of `in_progress`, `completed`, or


176548 Unique identifier for the MCP tool call approval request.177793 Unique identifier for the MCP tool call approval request.

176549 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.177794 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

176550 177795 

176551 - `error: optional string or null`177796 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

176552 177797 

176553 The error from the tool call, if any.177798 The error from the tool call, if any.

176554 177799 

177800 - `string`

177801 

177802 The error from the tool call, if any.

177803 

177804 - `McpProtocolError object { code, message, type }`

177805 

177806 - `code: number`

177807 

177808 - `message: string`

177809 

177810 - `type: "mcp_protocol_error"`

177811 

177812 - `"mcp_protocol_error"`

177813 

177814 - `McpToolExecutionError object { content, type }`

177815 

177816 - `content: unknown`

177817 

177818 - `type: "mcp_tool_execution_error"`

177819 

177820 - `"mcp_tool_execution_error"`

177821 

177822 - `HTTPError object { code, message, type }`

177823 

177824 - `code: number`

177825 

177826 - `message: string`

177827 

177828 - `type: "http_error"`

177829 

177830 - `"http_error"`

177831 

176555 - `output: optional string or null`177832 - `output: optional string or null`

176556 177833 

176557 The output from the tool call.177834 The output from the tool call.


179006 180283 

179007 - `item: BetaResponseOutputItem`180284 - `item: BetaResponseOutputItem`

179008 180285 

179009 The output item that was added.180286 The output item that was added. For reasoning items, `encrypted_content`

180287 may be incomplete while the item is in progress. Use the reasoning item

180288 from the corresponding `response.output_item.done` event when passing it

180289 as input to a subsequent request.

179010 180290 

179011 - `BetaResponseOutputMessage object { id, content, role, 4 more }`180291 - `BetaResponseOutputMessage object { id, content, role, 4 more }`

179012 180292 


180094 181374 

180095 Emitted when an annotation is added to output text content.181375 Emitted when an annotation is added to output text content.

180096 181376 

180097 - `annotation: unknown`181377 - `annotation: object { file_id, filename, index, type } or object { end_index, start_index, title, 2 more } or object { container_id, end_index, file_id, 3 more } or object { file_id, index, type } or null`

181378 

181379 An annotation that applies to a span of output text.

181380 

181381 - `FileCitation object { file_id, filename, index, type }`

181382 

181383 A citation to a file.

181384 

181385 - `file_id: string`

181386 

181387 The ID of the file.

181388 

181389 - `filename: string`

181390 

181391 The filename of the file cited.

181392 

181393 - `index: number`

181394 

181395 The index of the file in the list of files.

181396 

181397 - `type: "file_citation"`

181398 

181399 The type of the file citation. Always `file_citation`.

181400 

181401 - `"file_citation"`

181402 

181403 - `URLCitation object { end_index, start_index, title, 2 more }`

181404 

181405 A citation for a web resource used to generate a model response.

181406 

181407 - `end_index: number`

181408 

181409 The index of the last character of the URL citation in the message.

181410 

181411 - `start_index: number`

181412 

181413 The index of the first character of the URL citation in the message.

181414 

181415 - `title: string`

181416 

181417 The title of the web resource.

181418 

181419 - `type: "url_citation"`

181420 

181421 The type of the URL citation. Always `url_citation`.

181422 

181423 - `"url_citation"`

181424 

181425 - `url: string`

181426 

181427 The URL of the web resource.

181428 

181429 - `ContainerFileCitation object { container_id, end_index, file_id, 3 more }`

181430 

181431 A citation for a container file used to generate a model response.

181432 

181433 - `container_id: string`

181434 

181435 The ID of the container file.

181436 

181437 - `end_index: number`

181438 

181439 The index of the last character of the container file citation in the message.

181440 

181441 - `file_id: string`

181442 

181443 The ID of the file.

181444 

181445 - `filename: string`

181446 

181447 The filename of the container file cited.

181448 

181449 - `start_index: number`

181450 

181451 The index of the first character of the container file citation in the message.

181452 

181453 - `type: "container_file_citation"`

181454 

181455 The type of the container file citation. Always `container_file_citation`.

181456 

181457 - `"container_file_citation"`

181458 

181459 - `FilePath object { file_id, index, type }`

180098 181460 

180099 The annotation object being added. (See annotation schema for details.)181461 A path to a file.

181462 

181463 - `file_id: string`

181464 

181465 The ID of the file.

181466 

181467 - `index: number`

181468 

181469 The index of the file in the list of files.

181470 

181471 - `type: "file_path"`

181472 

181473 The type of the file path. Always `file_path`.

181474 

181475 - `"file_path"`

180100 181476 

180101 - `annotation_index: number`181477 - `annotation_index: number`

180102 181478 


184446 for reasoning items returned by `POST /v1/responses` and WebSocket185822 for reasoning items returned by `POST /v1/responses` and WebSocket

184447 `response.create` requests.185823 `response.create` requests.

184448 185824 

185825 When streaming, use the completed reasoning item and its

185826 `encrypted_content` from the `response.output_item.done` event in

185827 subsequent requests. The `encrypted_content` in

185828 `response.output_item.added` may be incomplete. This is especially

185829 important when `store` is `false` or when using Zero Data Retention.

185830 

184449 - `status: optional "in_progress" or "completed" or "incomplete"`185831 - `status: optional "in_progress" or "completed" or "incomplete"`

184450 185832 

184451 The status of the item. One of `in_progress`, `completed`, or185833 The status of the item. One of `in_progress`, `completed`, or


185219 Unique identifier for the MCP tool call approval request.186601 Unique identifier for the MCP tool call approval request.

185220 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.186602 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

185221 186603 

185222 - `error: optional string or null`186604 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

186605 

186606 The error from the tool call, if any.

186607 

186608 - `string`

185223 186609 

185224 The error from the tool call, if any.186610 The error from the tool call, if any.

185225 186611 

186612 - `McpProtocolError object { code, message, type }`

186613 

186614 - `code: number`

186615 

186616 - `message: string`

186617 

186618 - `type: "mcp_protocol_error"`

186619 

186620 - `"mcp_protocol_error"`

186621 

186622 - `McpToolExecutionError object { content, type }`

186623 

186624 - `content: unknown`

186625 

186626 - `type: "mcp_tool_execution_error"`

186627 

186628 - `"mcp_tool_execution_error"`

186629 

186630 - `HTTPError object { code, message, type }`

186631 

186632 - `code: number`

186633 

186634 - `message: string`

186635 

186636 - `type: "http_error"`

186637 

186638 - `"http_error"`

186639 

185226 - `output: optional string or null`186640 - `output: optional string or null`

185227 186641 

185228 The output from the tool call.186642 The output from the tool call.


190261 for reasoning items returned by `POST /v1/responses` and WebSocket191675 for reasoning items returned by `POST /v1/responses` and WebSocket

190262 `response.create` requests.191676 `response.create` requests.

190263 191677 

191678 When streaming, use the completed reasoning item and its

191679 `encrypted_content` from the `response.output_item.done` event in

191680 subsequent requests. The `encrypted_content` in

191681 `response.output_item.added` may be incomplete. This is especially

191682 important when `store` is `false` or when using Zero Data Retention.

191683 

190264 - `status: optional "in_progress" or "completed" or "incomplete"`191684 - `status: optional "in_progress" or "completed" or "incomplete"`

190265 191685 

190266 The status of the item. One of `in_progress`, `completed`, or191686 The status of the item. One of `in_progress`, `completed`, or


191010 Unique identifier for the MCP tool call approval request.192430 Unique identifier for the MCP tool call approval request.

191011 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.192431 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

191012 192432 

191013 - `error: optional string or null`192433 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

191014 192434 

191015 The error from the tool call, if any.192435 The error from the tool call, if any.

191016 192436 

192437 - `string`

192438 

192439 The error from the tool call, if any.

192440 

192441 - `McpProtocolError object { code, message, type }`

192442 

192443 - `code: number`

192444 

192445 - `message: string`

192446 

192447 - `type: "mcp_protocol_error"`

192448 

192449 - `"mcp_protocol_error"`

192450 

192451 - `McpToolExecutionError object { content, type }`

192452 

192453 - `content: unknown`

192454 

192455 - `type: "mcp_tool_execution_error"`

192456 

192457 - `"mcp_tool_execution_error"`

192458 

192459 - `HTTPError object { code, message, type }`

192460 

192461 - `code: number`

192462 

192463 - `message: string`

192464 

192465 - `type: "http_error"`

192466 

192467 - `"http_error"`

192468 

191017 - `output: optional string or null`192469 - `output: optional string or null`

191018 192470 

191019 The output from the tool call.192471 The output from the tool call.


191419 when the originating `response.create` event supplied a192871 when the originating `response.create` event supplied a

191420 `stream_id`.192872 `stream_id`.

191421 192873 

191422 - `BetaResponseWsError = BetaResponseErrorEvent`

191423 

191424 Emitted when an error occurs.

191425 

191426 - `stream_id: optional string`

191427 

191428 The WebSocket lane that emitted this event. This field is present

191429 when the originating `response.create` event supplied a

191430 `stream_id`.

191431 

191432 - `BetaResponseFileSearchCallWsCompleted = BetaResponseFileSearchCallCompletedEvent`192874 - `BetaResponseFileSearchCallWsCompleted = BetaResponseFileSearchCallCompletedEvent`

191433 192875 

191434 Emitted when a file search call is completed (results found).192876 Emitted when a file search call is completed (results found).


191819 when the originating `response.create` event supplied a193261 when the originating `response.create` event supplied a

191820 `stream_id`.193262 `stream_id`.

191821 193263 

193264 - `BetaResponseWsError object { error, type, agent, 3 more }`

193265 

193266 Emitted when an error occurs while processing a Responses WebSocket request.

193267 

193268 - `error: object { code, message, param, 2 more }`

193269 

193270 Details about the error.

193271 

193272 - `code: string or null`

193273 

193274 The error code that was emitted, if any.

193275 

193276 - `message: string`

193277 

193278 The human-readable error message that was emitted.

193279 

193280 - `param: string or null`

193281 

193282 The parameter name that was associated with the error, if any.

193283 

193284 - `type: string`

193285 

193286 The error type that was emitted.

193287 

193288 - `headers: optional map[string]`

193289 

193290 The response headers that were emitted with the error, if any.

193291 

193292 - `type: "error"`

193293 

193294 The type of the event. Always `error`.

193295 

193296 - `"error"`

193297 

193298 - `agent: optional object { agent_name } or null`

193299 

193300 The agent that owns this multi-agent streaming event.

193301 

193302 - `agent_name: string`

193303 

193304 The canonical name of the agent that produced this item.

193305 

193306 - `sequence_number: optional number`

193307 

193308 The sequence number of an error emitted by the response stream.

193309 

193310 - `status: optional number`

193311 

193312 The HTTP status code associated with a WebSocket protocol error.

193313 

193314 - `stream_id: optional string`

193315 

193316 The WebSocket lane that emitted this event. This field is present when the

193317 originating `response.create` event supplied a `stream_id`.

193318 

191822 - `BetaResponseInjectCreatedEvent object { response_id, sequence_number, type, stream_id }`193319 - `BetaResponseInjectCreatedEvent object { response_id, sequence_number, type, stream_id }`

191823 193320 

191824 Emitted when all injected input items were validated and committed to the193321 Emitted when all injected input items were validated and committed to the


195621 for reasoning items returned by `POST /v1/responses` and WebSocket197118 for reasoning items returned by `POST /v1/responses` and WebSocket

195622 `response.create` requests.197119 `response.create` requests.

195623 197120 

197121 When streaming, use the completed reasoning item and its

197122 `encrypted_content` from the `response.output_item.done` event in

197123 subsequent requests. The `encrypted_content` in

197124 `response.output_item.added` may be incomplete. This is especially

197125 important when `store` is `false` or when using Zero Data Retention.

197126 

195624 - `status: optional "in_progress" or "completed" or "incomplete"`197127 - `status: optional "in_progress" or "completed" or "incomplete"`

195625 197128 

195626 The status of the item. One of `in_progress`, `completed`, or197129 The status of the item. One of `in_progress`, `completed`, or


196394 Unique identifier for the MCP tool call approval request.197897 Unique identifier for the MCP tool call approval request.

196395 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.197898 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

196396 197899 

196397 - `error: optional string or null`197900 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

197901 

197902 The error from the tool call, if any.

197903 

197904 - `string`

196398 197905 

196399 The error from the tool call, if any.197906 The error from the tool call, if any.

196400 197907 

197908 - `McpProtocolError object { code, message, type }`

197909 

197910 - `code: number`

197911 

197912 - `message: string`

197913 

197914 - `type: "mcp_protocol_error"`

197915 

197916 - `"mcp_protocol_error"`

197917 

197918 - `McpToolExecutionError object { content, type }`

197919 

197920 - `content: unknown`

197921 

197922 - `type: "mcp_tool_execution_error"`

197923 

197924 - `"mcp_tool_execution_error"`

197925 

197926 - `HTTPError object { code, message, type }`

197927 

197928 - `code: number`

197929 

197930 - `message: string`

197931 

197932 - `type: "http_error"`

197933 

197934 - `"http_error"`

197935 

196401 - `output: optional string or null`197936 - `output: optional string or null`

196402 197937 

196403 The output from the tool call.197938 The output from the tool call.


200589 for reasoning items returned by `POST /v1/responses` and WebSocket202124 for reasoning items returned by `POST /v1/responses` and WebSocket

200590 `response.create` requests.202125 `response.create` requests.

200591 202126 

202127 When streaming, use the completed reasoning item and its

202128 `encrypted_content` from the `response.output_item.done` event in

202129 subsequent requests. The `encrypted_content` in

202130 `response.output_item.added` may be incomplete. This is especially

202131 important when `store` is `false` or when using Zero Data Retention.

202132 

200592 - `status: optional "in_progress" or "completed" or "incomplete"`202133 - `status: optional "in_progress" or "completed" or "incomplete"`

200593 202134 

200594 The status of the item. One of `in_progress`, `completed`, or202135 The status of the item. One of `in_progress`, `completed`, or


201454 Unique identifier for the MCP tool call approval request.202995 Unique identifier for the MCP tool call approval request.

201455 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.202996 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

201456 202997 

201457 - `error: optional string or null`202998 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

202999 

203000 The error from the tool call, if any.

203001 

203002 - `string`

201458 203003 

201459 The error from the tool call, if any.203004 The error from the tool call, if any.

201460 203005 

203006 - `McpProtocolError object { code, message, type }`

203007 

203008 - `code: number`

203009 

203010 - `message: string`

203011 

203012 - `type: "mcp_protocol_error"`

203013 

203014 - `"mcp_protocol_error"`

203015 

203016 - `McpToolExecutionError object { content, type }`

203017 

203018 - `content: unknown`

203019 

203020 - `type: "mcp_tool_execution_error"`

203021 

203022 - `"mcp_tool_execution_error"`

203023 

203024 - `HTTPError object { code, message, type }`

203025 

203026 - `code: number`

203027 

203028 - `message: string`

203029 

203030 - `type: "http_error"`

203031 

203032 - `"http_error"`

203033 

201461 - `output: optional string or null`203034 - `output: optional string or null`

201462 203035 

201463 The output from the tool call.203036 The output from the tool call.


205387 for reasoning items returned by `POST /v1/responses` and WebSocket206960 for reasoning items returned by `POST /v1/responses` and WebSocket

205388 `response.create` requests.206961 `response.create` requests.

205389 206962 

206963 When streaming, use the completed reasoning item and its

206964 `encrypted_content` from the `response.output_item.done` event in

206965 subsequent requests. The `encrypted_content` in

206966 `response.output_item.added` may be incomplete. This is especially

206967 important when `store` is `false` or when using Zero Data Retention.

206968 

205390 - `status: optional "in_progress" or "completed" or "incomplete"`206969 - `status: optional "in_progress" or "completed" or "incomplete"`

205391 206970 

205392 The status of the item. One of `in_progress`, `completed`, or206971 The status of the item. One of `in_progress`, `completed`, or


206252 Unique identifier for the MCP tool call approval request.207831 Unique identifier for the MCP tool call approval request.

206253 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.207832 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

206254 207833 

206255 - `error: optional string or null`207834 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

207835 

207836 The error from the tool call, if any.

207837 

207838 - `string`

206256 207839 

206257 The error from the tool call, if any.207840 The error from the tool call, if any.

206258 207841 

207842 - `McpProtocolError object { code, message, type }`

207843 

207844 - `code: number`

207845 

207846 - `message: string`

207847 

207848 - `type: "mcp_protocol_error"`

207849 

207850 - `"mcp_protocol_error"`

207851 

207852 - `McpToolExecutionError object { content, type }`

207853 

207854 - `content: unknown`

207855 

207856 - `type: "mcp_tool_execution_error"`

207857 

207858 - `"mcp_tool_execution_error"`

207859 

207860 - `HTTPError object { code, message, type }`

207861 

207862 - `code: number`

207863 

207864 - `message: string`

207865 

207866 - `type: "http_error"`

207867 

207868 - `"http_error"`

207869 

206259 - `output: optional string or null`207870 - `output: optional string or null`

206260 207871 

206261 The output from the tool call.207872 The output from the tool call.


210250 for reasoning items returned by `POST /v1/responses` and WebSocket211861 for reasoning items returned by `POST /v1/responses` and WebSocket

210251 `response.create` requests.211862 `response.create` requests.

210252 211863 

211864 When streaming, use the completed reasoning item and its

211865 `encrypted_content` from the `response.output_item.done` event in

211866 subsequent requests. The `encrypted_content` in

211867 `response.output_item.added` may be incomplete. This is especially

211868 important when `store` is `false` or when using Zero Data Retention.

211869 

210253 - `status: optional "in_progress" or "completed" or "incomplete"`211870 - `status: optional "in_progress" or "completed" or "incomplete"`

210254 211871 

210255 The status of the item. One of `in_progress`, `completed`, or211872 The status of the item. One of `in_progress`, `completed`, or


211023 Unique identifier for the MCP tool call approval request.212640 Unique identifier for the MCP tool call approval request.

211024 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.212641 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

211025 212642 

211026 - `error: optional string or null`212643 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

212644 

212645 The error from the tool call, if any.

212646 

212647 - `string`

211027 212648 

211028 The error from the tool call, if any.212649 The error from the tool call, if any.

211029 212650 

212651 - `McpProtocolError object { code, message, type }`

212652 

212653 - `code: number`

212654 

212655 - `message: string`

212656 

212657 - `type: "mcp_protocol_error"`

212658 

212659 - `"mcp_protocol_error"`

212660 

212661 - `McpToolExecutionError object { content, type }`

212662 

212663 - `content: unknown`

212664 

212665 - `type: "mcp_tool_execution_error"`

212666 

212667 - `"mcp_tool_execution_error"`

212668 

212669 - `HTTPError object { code, message, type }`

212670 

212671 - `code: number`

212672 

212673 - `message: string`

212674 

212675 - `type: "http_error"`

212676 

212677 - `"http_error"`

212678 

211030 - `output: optional string or null`212679 - `output: optional string or null`

211031 212680 

211032 The output from the tool call.212681 The output from the tool call.

Details

3864 for reasoning items returned by `POST /v1/responses` and WebSocket3864 for reasoning items returned by `POST /v1/responses` and WebSocket

3865 `response.create` requests.3865 `response.create` requests.

3866 3866 

3867 When streaming, use the completed reasoning item and its

3868 `encrypted_content` from the `response.output_item.done` event in

3869 subsequent requests. The `encrypted_content` in

3870 `response.output_item.added` may be incomplete. This is especially

3871 important when `store` is `false` or when using Zero Data Retention.

3872 

3867 - `status: optional "in_progress" or "completed" or "incomplete"`3873 - `status: optional "in_progress" or "completed" or "incomplete"`

3868 3874 

3869 The status of the item. One of `in_progress`, `completed`, or3875 The status of the item. One of `in_progress`, `completed`, or


4637 Unique identifier for the MCP tool call approval request.4643 Unique identifier for the MCP tool call approval request.

4638 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.4644 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

4639 4645 

4640 - `error: optional string or null`4646 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

4641 4647 

4642 The error from the tool call, if any.4648 The error from the tool call, if any.

4643 4649 

4650 - `string`

4651 

4652 The error from the tool call, if any.

4653 

4654 - `McpProtocolError object { code, message, type }`

4655 

4656 - `code: number`

4657 

4658 - `message: string`

4659 

4660 - `type: "mcp_protocol_error"`

4661 

4662 - `"mcp_protocol_error"`

4663 

4664 - `McpToolExecutionError object { content, type }`

4665 

4666 - `content: unknown`

4667 

4668 - `type: "mcp_tool_execution_error"`

4669 

4670 - `"mcp_tool_execution_error"`

4671 

4672 - `HTTPError object { code, message, type }`

4673 

4674 - `code: number`

4675 

4676 - `message: string`

4677 

4678 - `type: "http_error"`

4679 

4680 - `"http_error"`

4681 

4644 - `output: optional string or null`4682 - `output: optional string or null`

4645 4683 

4646 The output from the tool call.4684 The output from the tool call.


5926 for reasoning items returned by `POST /v1/responses` and WebSocket5964 for reasoning items returned by `POST /v1/responses` and WebSocket

5927 `response.create` requests.5965 `response.create` requests.

5928 5966 

5967 When streaming, use the completed reasoning item and its

5968 `encrypted_content` from the `response.output_item.done` event in

5969 subsequent requests. The `encrypted_content` in

5970 `response.output_item.added` may be incomplete. This is especially

5971 important when `store` is `false` or when using Zero Data Retention.

5972 

5929 - `status: optional "in_progress" or "completed" or "incomplete"`5973 - `status: optional "in_progress" or "completed" or "incomplete"`

5930 5974 

5931 The status of the item. One of `in_progress`, `completed`, or5975 The status of the item. One of `in_progress`, `completed`, or


8803 Unique identifier for the MCP tool call approval request.8847 Unique identifier for the MCP tool call approval request.

8804 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.8848 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

8805 8849 

8806 - `error: optional string or null`8850 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

8851 

8852 The error from the tool call, if any.

8853 

8854 - `string`

8807 8855 

8808 The error from the tool call, if any.8856 The error from the tool call, if any.

8809 8857 

8858 - `McpProtocolError object { code, message, type }`

8859 

8860 - `code: number`

8861 

8862 - `message: string`

8863 

8864 - `type: "mcp_protocol_error"`

8865 

8866 - `"mcp_protocol_error"`

8867 

8868 - `McpToolExecutionError object { content, type }`

8869 

8870 - `content: unknown`

8871 

8872 - `type: "mcp_tool_execution_error"`

8873 

8874 - `"mcp_tool_execution_error"`

8875 

8876 - `HTTPError object { code, message, type }`

8877 

8878 - `code: number`

8879 

8880 - `message: string`

8881 

8882 - `type: "http_error"`

8883 

8884 - `"http_error"`

8885 

8810 - `output: optional string or null`8886 - `output: optional string or null`

8811 8887 

8812 The output from the tool call.8888 The output from the tool call.


15057 for reasoning items returned by `POST /v1/responses` and WebSocket15133 for reasoning items returned by `POST /v1/responses` and WebSocket

15058 `response.create` requests.15134 `response.create` requests.

15059 15135 

15136 When streaming, use the completed reasoning item and its

15137 `encrypted_content` from the `response.output_item.done` event in

15138 subsequent requests. The `encrypted_content` in

15139 `response.output_item.added` may be incomplete. This is especially

15140 important when `store` is `false` or when using Zero Data Retention.

15141 

15060 - `status: optional "in_progress" or "completed" or "incomplete"`15142 - `status: optional "in_progress" or "completed" or "incomplete"`

15061 15143 

15062 The status of the item. One of `in_progress`, `completed`, or15144 The status of the item. One of `in_progress`, `completed`, or


15830 Unique identifier for the MCP tool call approval request.15912 Unique identifier for the MCP tool call approval request.

15831 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.15913 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

15832 15914 

15833 - `error: optional string or null`15915 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

15916 

15917 The error from the tool call, if any.

15918 

15919 - `string`

15834 15920 

15835 The error from the tool call, if any.15921 The error from the tool call, if any.

15836 15922 

15923 - `McpProtocolError object { code, message, type }`

15924 

15925 - `code: number`

15926 

15927 - `message: string`

15928 

15929 - `type: "mcp_protocol_error"`

15930 

15931 - `"mcp_protocol_error"`

15932 

15933 - `McpToolExecutionError object { content, type }`

15934 

15935 - `content: unknown`

15936 

15937 - `type: "mcp_tool_execution_error"`

15938 

15939 - `"mcp_tool_execution_error"`

15940 

15941 - `HTTPError object { code, message, type }`

15942 

15943 - `code: number`

15944 

15945 - `message: string`

15946 

15947 - `type: "http_error"`

15948 

15949 - `"http_error"`

15950 

15837 - `output: optional string or null`15951 - `output: optional string or null`

15838 15952 

15839 The output from the tool call.15953 The output from the tool call.


19982 for reasoning items returned by `POST /v1/responses` and WebSocket20096 for reasoning items returned by `POST /v1/responses` and WebSocket

19983 `response.create` requests.20097 `response.create` requests.

19984 20098 

20099 When streaming, use the completed reasoning item and its

20100 `encrypted_content` from the `response.output_item.done` event in

20101 subsequent requests. The `encrypted_content` in

20102 `response.output_item.added` may be incomplete. This is especially

20103 important when `store` is `false` or when using Zero Data Retention.

20104 

19985 - `status: optional "in_progress" or "completed" or "incomplete"`20105 - `status: optional "in_progress" or "completed" or "incomplete"`

19986 20106 

19987 The status of the item. One of `in_progress`, `completed`, or20107 The status of the item. One of `in_progress`, `completed`, or


20741 Unique identifier for the MCP tool call approval request.20861 Unique identifier for the MCP tool call approval request.

20742 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.20862 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

20743 20863 

20744 - `error: optional string or null`20864 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

20745 20865 

20746 The error from the tool call, if any.20866 The error from the tool call, if any.

20747 20867 

20868 - `string`

20869 

20870 The error from the tool call, if any.

20871 

20872 - `McpProtocolError object { code, message, type }`

20873 

20874 - `code: number`

20875 

20876 - `message: string`

20877 

20878 - `type: "mcp_protocol_error"`

20879 

20880 - `"mcp_protocol_error"`

20881 

20882 - `McpToolExecutionError object { content, type }`

20883 

20884 - `content: unknown`

20885 

20886 - `type: "mcp_tool_execution_error"`

20887 

20888 - `"mcp_tool_execution_error"`

20889 

20890 - `HTTPError object { code, message, type }`

20891 

20892 - `code: number`

20893 

20894 - `message: string`

20895 

20896 - `type: "http_error"`

20897 

20898 - `"http_error"`

20899 

20748 - `output: optional string or null`20900 - `output: optional string or null`

20749 20901 

20750 The output from the tool call.20902 The output from the tool call.


24916 for reasoning items returned by `POST /v1/responses` and WebSocket25068 for reasoning items returned by `POST /v1/responses` and WebSocket

24917 `response.create` requests.25069 `response.create` requests.

24918 25070 

25071 When streaming, use the completed reasoning item and its

25072 `encrypted_content` from the `response.output_item.done` event in

25073 subsequent requests. The `encrypted_content` in

25074 `response.output_item.added` may be incomplete. This is especially

25075 important when `store` is `false` or when using Zero Data Retention.

25076 

24919 - `status: optional "in_progress" or "completed" or "incomplete"`25077 - `status: optional "in_progress" or "completed" or "incomplete"`

24920 25078 

24921 The status of the item. One of `in_progress`, `completed`, or25079 The status of the item. One of `in_progress`, `completed`, or


25689 Unique identifier for the MCP tool call approval request.25847 Unique identifier for the MCP tool call approval request.

25690 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.25848 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

25691 25849 

25692 - `error: optional string or null`25850 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

25851 

25852 The error from the tool call, if any.

25853 

25854 - `string`

25693 25855 

25694 The error from the tool call, if any.25856 The error from the tool call, if any.

25695 25857 

25858 - `McpProtocolError object { code, message, type }`

25859 

25860 - `code: number`

25861 

25862 - `message: string`

25863 

25864 - `type: "mcp_protocol_error"`

25865 

25866 - `"mcp_protocol_error"`

25867 

25868 - `McpToolExecutionError object { content, type }`

25869 

25870 - `content: unknown`

25871 

25872 - `type: "mcp_tool_execution_error"`

25873 

25874 - `"mcp_tool_execution_error"`

25875 

25876 - `HTTPError object { code, message, type }`

25877 

25878 - `code: number`

25879 

25880 - `message: string`

25881 

25882 - `type: "http_error"`

25883 

25884 - `"http_error"`

25885 

25696 - `output: optional string or null`25886 - `output: optional string or null`

25697 25887 

25698 The output from the tool call.25888 The output from the tool call.


31641 for reasoning items returned by `POST /v1/responses` and WebSocket31831 for reasoning items returned by `POST /v1/responses` and WebSocket

31642 `response.create` requests.31832 `response.create` requests.

31643 31833 

31834 When streaming, use the completed reasoning item and its

31835 `encrypted_content` from the `response.output_item.done` event in

31836 subsequent requests. The `encrypted_content` in

31837 `response.output_item.added` may be incomplete. This is especially

31838 important when `store` is `false` or when using Zero Data Retention.

31839 

31644 - `status: optional "in_progress" or "completed" or "incomplete"`31840 - `status: optional "in_progress" or "completed" or "incomplete"`

31645 31841 

31646 The status of the item. One of `in_progress`, `completed`, or31842 The status of the item. One of `in_progress`, `completed`, or


32414 Unique identifier for the MCP tool call approval request.32610 Unique identifier for the MCP tool call approval request.

32415 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.32611 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

32416 32612 

32417 - `error: optional string or null`32613 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

32614 

32615 The error from the tool call, if any.

32616 

32617 - `string`

32418 32618 

32419 The error from the tool call, if any.32619 The error from the tool call, if any.

32420 32620 

32621 - `McpProtocolError object { code, message, type }`

32622 

32623 - `code: number`

32624 

32625 - `message: string`

32626 

32627 - `type: "mcp_protocol_error"`

32628 

32629 - `"mcp_protocol_error"`

32630 

32631 - `McpToolExecutionError object { content, type }`

32632 

32633 - `content: unknown`

32634 

32635 - `type: "mcp_tool_execution_error"`

32636 

32637 - `"mcp_tool_execution_error"`

32638 

32639 - `HTTPError object { code, message, type }`

32640 

32641 - `code: number`

32642 

32643 - `message: string`

32644 

32645 - `type: "http_error"`

32646 

32647 - `"http_error"`

32648 

32421 - `output: optional string or null`32649 - `output: optional string or null`

32422 32650 

32423 The output from the tool call.32651 The output from the tool call.


33703 for reasoning items returned by `POST /v1/responses` and WebSocket33931 for reasoning items returned by `POST /v1/responses` and WebSocket

33704 `response.create` requests.33932 `response.create` requests.

33705 33933 

33934 When streaming, use the completed reasoning item and its

33935 `encrypted_content` from the `response.output_item.done` event in

33936 subsequent requests. The `encrypted_content` in

33937 `response.output_item.added` may be incomplete. This is especially

33938 important when `store` is `false` or when using Zero Data Retention.

33939 

33706 - `status: optional "in_progress" or "completed" or "incomplete"`33940 - `status: optional "in_progress" or "completed" or "incomplete"`

33707 33941 

33708 The status of the item. One of `in_progress`, `completed`, or33942 The status of the item. One of `in_progress`, `completed`, or


36580 Unique identifier for the MCP tool call approval request.36814 Unique identifier for the MCP tool call approval request.

36581 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.36815 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

36582 36816 

36583 - `error: optional string or null`36817 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

36584 36818 

36585 The error from the tool call, if any.36819 The error from the tool call, if any.

36586 36820 

36821 - `string`

36822 

36823 The error from the tool call, if any.

36824 

36825 - `McpProtocolError object { code, message, type }`

36826 

36827 - `code: number`

36828 

36829 - `message: string`

36830 

36831 - `type: "mcp_protocol_error"`

36832 

36833 - `"mcp_protocol_error"`

36834 

36835 - `McpToolExecutionError object { content, type }`

36836 

36837 - `content: unknown`

36838 

36839 - `type: "mcp_tool_execution_error"`

36840 

36841 - `"mcp_tool_execution_error"`

36842 

36843 - `HTTPError object { code, message, type }`

36844 

36845 - `code: number`

36846 

36847 - `message: string`

36848 

36849 - `type: "http_error"`

36850 

36851 - `"http_error"`

36852 

36587 - `output: optional string or null`36853 - `output: optional string or null`

36588 36854 

36589 The output from the tool call.36855 The output from the tool call.


43497 for reasoning items returned by `POST /v1/responses` and WebSocket43763 for reasoning items returned by `POST /v1/responses` and WebSocket

43498 `response.create` requests.43764 `response.create` requests.

43499 43765 

43766 When streaming, use the completed reasoning item and its

43767 `encrypted_content` from the `response.output_item.done` event in

43768 subsequent requests. The `encrypted_content` in

43769 `response.output_item.added` may be incomplete. This is especially

43770 important when `store` is `false` or when using Zero Data Retention.

43771 

43500 - `status: optional "in_progress" or "completed" or "incomplete"`43772 - `status: optional "in_progress" or "completed" or "incomplete"`

43501 43773 

43502 The status of the item. One of `in_progress`, `completed`, or43774 The status of the item. One of `in_progress`, `completed`, or


44270 Unique identifier for the MCP tool call approval request.44542 Unique identifier for the MCP tool call approval request.

44271 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.44543 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

44272 44544 

44273 - `error: optional string or null`44545 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

44546 

44547 The error from the tool call, if any.

44548 

44549 - `string`

44274 44550 

44275 The error from the tool call, if any.44551 The error from the tool call, if any.

44276 44552 

44553 - `McpProtocolError object { code, message, type }`

44554 

44555 - `code: number`

44556 

44557 - `message: string`

44558 

44559 - `type: "mcp_protocol_error"`

44560 

44561 - `"mcp_protocol_error"`

44562 

44563 - `McpToolExecutionError object { content, type }`

44564 

44565 - `content: unknown`

44566 

44567 - `type: "mcp_tool_execution_error"`

44568 

44569 - `"mcp_tool_execution_error"`

44570 

44571 - `HTTPError object { code, message, type }`

44572 

44573 - `code: number`

44574 

44575 - `message: string`

44576 

44577 - `type: "http_error"`

44578 

44579 - `"http_error"`

44580 

44277 - `output: optional string or null`44581 - `output: optional string or null`

44278 44582 

44279 The output from the tool call.44583 The output from the tool call.


45559 for reasoning items returned by `POST /v1/responses` and WebSocket45863 for reasoning items returned by `POST /v1/responses` and WebSocket

45560 `response.create` requests.45864 `response.create` requests.

45561 45865 

45866 When streaming, use the completed reasoning item and its

45867 `encrypted_content` from the `response.output_item.done` event in

45868 subsequent requests. The `encrypted_content` in

45869 `response.output_item.added` may be incomplete. This is especially

45870 important when `store` is `false` or when using Zero Data Retention.

45871 

45562 - `status: optional "in_progress" or "completed" or "incomplete"`45872 - `status: optional "in_progress" or "completed" or "incomplete"`

45563 45873 

45564 The status of the item. One of `in_progress`, `completed`, or45874 The status of the item. One of `in_progress`, `completed`, or


48436 Unique identifier for the MCP tool call approval request.48746 Unique identifier for the MCP tool call approval request.

48437 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.48747 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

48438 48748 

48439 - `error: optional string or null`48749 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

48750 

48751 The error from the tool call, if any.

48752 

48753 - `string`

48440 48754 

48441 The error from the tool call, if any.48755 The error from the tool call, if any.

48442 48756 

48757 - `McpProtocolError object { code, message, type }`

48758 

48759 - `code: number`

48760 

48761 - `message: string`

48762 

48763 - `type: "mcp_protocol_error"`

48764 

48765 - `"mcp_protocol_error"`

48766 

48767 - `McpToolExecutionError object { content, type }`

48768 

48769 - `content: unknown`

48770 

48771 - `type: "mcp_tool_execution_error"`

48772 

48773 - `"mcp_tool_execution_error"`

48774 

48775 - `HTTPError object { code, message, type }`

48776 

48777 - `code: number`

48778 

48779 - `message: string`

48780 

48781 - `type: "http_error"`

48782 

48783 - `"http_error"`

48784 

48443 - `output: optional string or null`48785 - `output: optional string or null`

48444 48786 

48445 The output from the tool call.48787 The output from the tool call.


54542 for reasoning items returned by `POST /v1/responses` and WebSocket54884 for reasoning items returned by `POST /v1/responses` and WebSocket

54543 `response.create` requests.54885 `response.create` requests.

54544 54886 

54887 When streaming, use the completed reasoning item and its

54888 `encrypted_content` from the `response.output_item.done` event in

54889 subsequent requests. The `encrypted_content` in

54890 `response.output_item.added` may be incomplete. This is especially

54891 important when `store` is `false` or when using Zero Data Retention.

54892 

54545 - `status: optional "in_progress" or "completed" or "incomplete"`54893 - `status: optional "in_progress" or "completed" or "incomplete"`

54546 54894 

54547 The status of the item. One of `in_progress`, `completed`, or54895 The status of the item. One of `in_progress`, `completed`, or


55301 Unique identifier for the MCP tool call approval request.55649 Unique identifier for the MCP tool call approval request.

55302 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.55650 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

55303 55651 

55304 - `error: optional string or null`55652 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

55305 55653 

55306 The error from the tool call, if any.55654 The error from the tool call, if any.

55307 55655 

55656 - `string`

55657 

55658 The error from the tool call, if any.

55659 

55660 - `McpProtocolError object { code, message, type }`

55661 

55662 - `code: number`

55663 

55664 - `message: string`

55665 

55666 - `type: "mcp_protocol_error"`

55667 

55668 - `"mcp_protocol_error"`

55669 

55670 - `McpToolExecutionError object { content, type }`

55671 

55672 - `content: unknown`

55673 

55674 - `type: "mcp_tool_execution_error"`

55675 

55676 - `"mcp_tool_execution_error"`

55677 

55678 - `HTTPError object { code, message, type }`

55679 

55680 - `code: number`

55681 

55682 - `message: string`

55683 

55684 - `type: "http_error"`

55685 

55686 - `"http_error"`

55687 

55308 - `output: optional string or null`55688 - `output: optional string or null`

55309 55689 

55310 The output from the tool call.55690 The output from the tool call.


60191 for reasoning items returned by `POST /v1/responses` and WebSocket60571 for reasoning items returned by `POST /v1/responses` and WebSocket

60192 `response.create` requests.60572 `response.create` requests.

60193 60573 

60574 When streaming, use the completed reasoning item and its

60575 `encrypted_content` from the `response.output_item.done` event in

60576 subsequent requests. The `encrypted_content` in

60577 `response.output_item.added` may be incomplete. This is especially

60578 important when `store` is `false` or when using Zero Data Retention.

60579 

60194 - `status: optional "in_progress" or "completed" or "incomplete"`60580 - `status: optional "in_progress" or "completed" or "incomplete"`

60195 60581 

60196 The status of the item. One of `in_progress`, `completed`, or60582 The status of the item. One of `in_progress`, `completed`, or


60964 Unique identifier for the MCP tool call approval request.61350 Unique identifier for the MCP tool call approval request.

60965 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.61351 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

60966 61352 

60967 - `error: optional string or null`61353 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

61354 

61355 The error from the tool call, if any.

61356 

61357 - `string`

60968 61358 

60969 The error from the tool call, if any.61359 The error from the tool call, if any.

60970 61360 

61361 - `McpProtocolError object { code, message, type }`

61362 

61363 - `code: number`

61364 

61365 - `message: string`

61366 

61367 - `type: "mcp_protocol_error"`

61368 

61369 - `"mcp_protocol_error"`

61370 

61371 - `McpToolExecutionError object { content, type }`

61372 

61373 - `content: unknown`

61374 

61375 - `type: "mcp_tool_execution_error"`

61376 

61377 - `"mcp_tool_execution_error"`

61378 

61379 - `HTTPError object { code, message, type }`

61380 

61381 - `code: number`

61382 

61383 - `message: string`

61384 

61385 - `type: "http_error"`

61386 

61387 - `"http_error"`

61388 

60971 - `output: optional string or null`61389 - `output: optional string or null`

60972 61390 

60973 The output from the tool call.61391 The output from the tool call.


62253 for reasoning items returned by `POST /v1/responses` and WebSocket62671 for reasoning items returned by `POST /v1/responses` and WebSocket

62254 `response.create` requests.62672 `response.create` requests.

62255 62673 

62674 When streaming, use the completed reasoning item and its

62675 `encrypted_content` from the `response.output_item.done` event in

62676 subsequent requests. The `encrypted_content` in

62677 `response.output_item.added` may be incomplete. This is especially

62678 important when `store` is `false` or when using Zero Data Retention.

62679 

62256 - `status: optional "in_progress" or "completed" or "incomplete"`62680 - `status: optional "in_progress" or "completed" or "incomplete"`

62257 62681 

62258 The status of the item. One of `in_progress`, `completed`, or62682 The status of the item. One of `in_progress`, `completed`, or


65130 Unique identifier for the MCP tool call approval request.65554 Unique identifier for the MCP tool call approval request.

65131 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.65555 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

65132 65556 

65133 - `error: optional string or null`65557 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

65558 

65559 The error from the tool call, if any.

65560 

65561 - `string`

65134 65562 

65135 The error from the tool call, if any.65563 The error from the tool call, if any.

65136 65564 

65565 - `McpProtocolError object { code, message, type }`

65566 

65567 - `code: number`

65568 

65569 - `message: string`

65570 

65571 - `type: "mcp_protocol_error"`

65572 

65573 - `"mcp_protocol_error"`

65574 

65575 - `McpToolExecutionError object { content, type }`

65576 

65577 - `content: unknown`

65578 

65579 - `type: "mcp_tool_execution_error"`

65580 

65581 - `"mcp_tool_execution_error"`

65582 

65583 - `HTTPError object { code, message, type }`

65584 

65585 - `code: number`

65586 

65587 - `message: string`

65588 

65589 - `type: "http_error"`

65590 

65591 - `"http_error"`

65592 

65137 - `output: optional string or null`65593 - `output: optional string or null`

65138 65594 

65139 The output from the tool call.65595 The output from the tool call.


71270 for reasoning items returned by `POST /v1/responses` and WebSocket71726 for reasoning items returned by `POST /v1/responses` and WebSocket

71271 `response.create` requests.71727 `response.create` requests.

71272 71728 

71729 When streaming, use the completed reasoning item and its

71730 `encrypted_content` from the `response.output_item.done` event in

71731 subsequent requests. The `encrypted_content` in

71732 `response.output_item.added` may be incomplete. This is especially

71733 important when `store` is `false` or when using Zero Data Retention.

71734 

71273 - `status: optional "in_progress" or "completed" or "incomplete"`71735 - `status: optional "in_progress" or "completed" or "incomplete"`

71274 71736 

71275 The status of the item. One of `in_progress`, `completed`, or71737 The status of the item. One of `in_progress`, `completed`, or


72043 Unique identifier for the MCP tool call approval request.72505 Unique identifier for the MCP tool call approval request.

72044 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.72506 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

72045 72507 

72046 - `error: optional string or null`72508 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

72047 72509 

72048 The error from the tool call, if any.72510 The error from the tool call, if any.

72049 72511 

72512 - `string`

72513 

72514 The error from the tool call, if any.

72515 

72516 - `McpProtocolError object { code, message, type }`

72517 

72518 - `code: number`

72519 

72520 - `message: string`

72521 

72522 - `type: "mcp_protocol_error"`

72523 

72524 - `"mcp_protocol_error"`

72525 

72526 - `McpToolExecutionError object { content, type }`

72527 

72528 - `content: unknown`

72529 

72530 - `type: "mcp_tool_execution_error"`

72531 

72532 - `"mcp_tool_execution_error"`

72533 

72534 - `HTTPError object { code, message, type }`

72535 

72536 - `code: number`

72537 

72538 - `message: string`

72539 

72540 - `type: "http_error"`

72541 

72542 - `"http_error"`

72543 

72050 - `output: optional string or null`72544 - `output: optional string or null`

72051 72545 

72052 The output from the tool call.72546 The output from the tool call.


73332 for reasoning items returned by `POST /v1/responses` and WebSocket73826 for reasoning items returned by `POST /v1/responses` and WebSocket

73333 `response.create` requests.73827 `response.create` requests.

73334 73828 

73829 When streaming, use the completed reasoning item and its

73830 `encrypted_content` from the `response.output_item.done` event in

73831 subsequent requests. The `encrypted_content` in

73832 `response.output_item.added` may be incomplete. This is especially

73833 important when `store` is `false` or when using Zero Data Retention.

73834 

73335 - `status: optional "in_progress" or "completed" or "incomplete"`73835 - `status: optional "in_progress" or "completed" or "incomplete"`

73336 73836 

73337 The status of the item. One of `in_progress`, `completed`, or73837 The status of the item. One of `in_progress`, `completed`, or


76209 Unique identifier for the MCP tool call approval request.76709 Unique identifier for the MCP tool call approval request.

76210 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.76710 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

76211 76711 

76212 - `error: optional string or null`76712 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

76713 

76714 The error from the tool call, if any.

76715 

76716 - `string`

76213 76717 

76214 The error from the tool call, if any.76718 The error from the tool call, if any.

76215 76719 

76720 - `McpProtocolError object { code, message, type }`

76721 

76722 - `code: number`

76723 

76724 - `message: string`

76725 

76726 - `type: "mcp_protocol_error"`

76727 

76728 - `"mcp_protocol_error"`

76729 

76730 - `McpToolExecutionError object { content, type }`

76731 

76732 - `content: unknown`

76733 

76734 - `type: "mcp_tool_execution_error"`

76735 

76736 - `"mcp_tool_execution_error"`

76737 

76738 - `HTTPError object { code, message, type }`

76739 

76740 - `code: number`

76741 

76742 - `message: string`

76743 

76744 - `type: "http_error"`

76745 

76746 - `"http_error"`

76747 

76216 - `output: optional string or null`76748 - `output: optional string or null`

76217 76749 

76218 The output from the tool call.76750 The output from the tool call.


82810 for reasoning items returned by `POST /v1/responses` and WebSocket83342 for reasoning items returned by `POST /v1/responses` and WebSocket

82811 `response.create` requests.83343 `response.create` requests.

82812 83344 

83345 When streaming, use the completed reasoning item and its

83346 `encrypted_content` from the `response.output_item.done` event in

83347 subsequent requests. The `encrypted_content` in

83348 `response.output_item.added` may be incomplete. This is especially

83349 important when `store` is `false` or when using Zero Data Retention.

83350 

82813 - `status: optional "in_progress" or "completed" or "incomplete"`83351 - `status: optional "in_progress" or "completed" or "incomplete"`

82814 83352 

82815 The status of the item. One of `in_progress`, `completed`, or83353 The status of the item. One of `in_progress`, `completed`, or


83583 Unique identifier for the MCP tool call approval request.84121 Unique identifier for the MCP tool call approval request.

83584 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.84122 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

83585 84123 

83586 - `error: optional string or null`84124 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

84125 

84126 The error from the tool call, if any.

84127 

84128 - `string`

83587 84129 

83588 The error from the tool call, if any.84130 The error from the tool call, if any.

83589 84131 

84132 - `McpProtocolError object { code, message, type }`

84133 

84134 - `code: number`

84135 

84136 - `message: string`

84137 

84138 - `type: "mcp_protocol_error"`

84139 

84140 - `"mcp_protocol_error"`

84141 

84142 - `McpToolExecutionError object { content, type }`

84143 

84144 - `content: unknown`

84145 

84146 - `type: "mcp_tool_execution_error"`

84147 

84148 - `"mcp_tool_execution_error"`

84149 

84150 - `HTTPError object { code, message, type }`

84151 

84152 - `code: number`

84153 

84154 - `message: string`

84155 

84156 - `type: "http_error"`

84157 

84158 - `"http_error"`

84159 

83590 - `output: optional string or null`84160 - `output: optional string or null`

83591 84161 

83592 The output from the tool call.84162 The output from the tool call.


84872 for reasoning items returned by `POST /v1/responses` and WebSocket85442 for reasoning items returned by `POST /v1/responses` and WebSocket

84873 `response.create` requests.85443 `response.create` requests.

84874 85444 

85445 When streaming, use the completed reasoning item and its

85446 `encrypted_content` from the `response.output_item.done` event in

85447 subsequent requests. The `encrypted_content` in

85448 `response.output_item.added` may be incomplete. This is especially

85449 important when `store` is `false` or when using Zero Data Retention.

85450 

84875 - `status: optional "in_progress" or "completed" or "incomplete"`85451 - `status: optional "in_progress" or "completed" or "incomplete"`

84876 85452 

84877 The status of the item. One of `in_progress`, `completed`, or85453 The status of the item. One of `in_progress`, `completed`, or


87749 Unique identifier for the MCP tool call approval request.88325 Unique identifier for the MCP tool call approval request.

87750 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.88326 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

87751 88327 

87752 - `error: optional string or null`88328 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

87753 88329 

87754 The error from the tool call, if any.88330 The error from the tool call, if any.

87755 88331 

88332 - `string`

88333 

88334 The error from the tool call, if any.

88335 

88336 - `McpProtocolError object { code, message, type }`

88337 

88338 - `code: number`

88339 

88340 - `message: string`

88341 

88342 - `type: "mcp_protocol_error"`

88343 

88344 - `"mcp_protocol_error"`

88345 

88346 - `McpToolExecutionError object { content, type }`

88347 

88348 - `content: unknown`

88349 

88350 - `type: "mcp_tool_execution_error"`

88351 

88352 - `"mcp_tool_execution_error"`

88353 

88354 - `HTTPError object { code, message, type }`

88355 

88356 - `code: number`

88357 

88358 - `message: string`

88359 

88360 - `type: "http_error"`

88361 

88362 - `"http_error"`

88363 

87756 - `output: optional string or null`88364 - `output: optional string or null`

87757 88365 

87758 The output from the tool call.88366 The output from the tool call.


93797 for reasoning items returned by `POST /v1/responses` and WebSocket94405 for reasoning items returned by `POST /v1/responses` and WebSocket

93798 `response.create` requests.94406 `response.create` requests.

93799 94407 

94408 When streaming, use the completed reasoning item and its

94409 `encrypted_content` from the `response.output_item.done` event in

94410 subsequent requests. The `encrypted_content` in

94411 `response.output_item.added` may be incomplete. This is especially

94412 important when `store` is `false` or when using Zero Data Retention.

94413 

93800 - `status: optional "in_progress" or "completed" or "incomplete"`94414 - `status: optional "in_progress" or "completed" or "incomplete"`

93801 94415 

93802 The status of the item. One of `in_progress`, `completed`, or94416 The status of the item. One of `in_progress`, `completed`, or


94570 Unique identifier for the MCP tool call approval request.95184 Unique identifier for the MCP tool call approval request.

94571 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.95185 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

94572 95186 

94573 - `error: optional string or null`95187 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

95188 

95189 The error from the tool call, if any.

95190 

95191 - `string`

94574 95192 

94575 The error from the tool call, if any.95193 The error from the tool call, if any.

94576 95194 

95195 - `McpProtocolError object { code, message, type }`

95196 

95197 - `code: number`

95198 

95199 - `message: string`

95200 

95201 - `type: "mcp_protocol_error"`

95202 

95203 - `"mcp_protocol_error"`

95204 

95205 - `McpToolExecutionError object { content, type }`

95206 

95207 - `content: unknown`

95208 

95209 - `type: "mcp_tool_execution_error"`

95210 

95211 - `"mcp_tool_execution_error"`

95212 

95213 - `HTTPError object { code, message, type }`

95214 

95215 - `code: number`

95216 

95217 - `message: string`

95218 

95219 - `type: "http_error"`

95220 

95221 - `"http_error"`

95222 

94577 - `output: optional string or null`95223 - `output: optional string or null`

94578 95224 

94579 The output from the tool call.95225 The output from the tool call.


95859 for reasoning items returned by `POST /v1/responses` and WebSocket96505 for reasoning items returned by `POST /v1/responses` and WebSocket

95860 `response.create` requests.96506 `response.create` requests.

95861 96507 

96508 When streaming, use the completed reasoning item and its

96509 `encrypted_content` from the `response.output_item.done` event in

96510 subsequent requests. The `encrypted_content` in

96511 `response.output_item.added` may be incomplete. This is especially

96512 important when `store` is `false` or when using Zero Data Retention.

96513 

95862 - `status: optional "in_progress" or "completed" or "incomplete"`96514 - `status: optional "in_progress" or "completed" or "incomplete"`

95863 96515 

95864 The status of the item. One of `in_progress`, `completed`, or96516 The status of the item. One of `in_progress`, `completed`, or


98736 Unique identifier for the MCP tool call approval request.99388 Unique identifier for the MCP tool call approval request.

98737 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.99389 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

98738 99390 

98739 - `error: optional string or null`99391 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

99392 

99393 The error from the tool call, if any.

99394 

99395 - `string`

98740 99396 

98741 The error from the tool call, if any.99397 The error from the tool call, if any.

98742 99398 

99399 - `McpProtocolError object { code, message, type }`

99400 

99401 - `code: number`

99402 

99403 - `message: string`

99404 

99405 - `type: "mcp_protocol_error"`

99406 

99407 - `"mcp_protocol_error"`

99408 

99409 - `McpToolExecutionError object { content, type }`

99410 

99411 - `content: unknown`

99412 

99413 - `type: "mcp_tool_execution_error"`

99414 

99415 - `"mcp_tool_execution_error"`

99416 

99417 - `HTTPError object { code, message, type }`

99418 

99419 - `code: number`

99420 

99421 - `message: string`

99422 

99423 - `type: "http_error"`

99424 

99425 - `"http_error"`

99426 

98743 - `output: optional string or null`99427 - `output: optional string or null`

98744 99428 

98745 The output from the tool call.99429 The output from the tool call.


105081 for reasoning items returned by `POST /v1/responses` and WebSocket105765 for reasoning items returned by `POST /v1/responses` and WebSocket

105082 `response.create` requests.105766 `response.create` requests.

105083 105767 

105768 When streaming, use the completed reasoning item and its

105769 `encrypted_content` from the `response.output_item.done` event in

105770 subsequent requests. The `encrypted_content` in

105771 `response.output_item.added` may be incomplete. This is especially

105772 important when `store` is `false` or when using Zero Data Retention.

105773 

105084 - `status: optional "in_progress" or "completed" or "incomplete"`105774 - `status: optional "in_progress" or "completed" or "incomplete"`

105085 105775 

105086 The status of the item. One of `in_progress`, `completed`, or105776 The status of the item. One of `in_progress`, `completed`, or


105854 Unique identifier for the MCP tool call approval request.106544 Unique identifier for the MCP tool call approval request.

105855 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.106545 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

105856 106546 

105857 - `error: optional string or null`106547 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

105858 106548 

105859 The error from the tool call, if any.106549 The error from the tool call, if any.

105860 106550 

106551 - `string`

106552 

106553 The error from the tool call, if any.

106554 

106555 - `McpProtocolError object { code, message, type }`

106556 

106557 - `code: number`

106558 

106559 - `message: string`

106560 

106561 - `type: "mcp_protocol_error"`

106562 

106563 - `"mcp_protocol_error"`

106564 

106565 - `McpToolExecutionError object { content, type }`

106566 

106567 - `content: unknown`

106568 

106569 - `type: "mcp_tool_execution_error"`

106570 

106571 - `"mcp_tool_execution_error"`

106572 

106573 - `HTTPError object { code, message, type }`

106574 

106575 - `code: number`

106576 

106577 - `message: string`

106578 

106579 - `type: "http_error"`

106580 

106581 - `"http_error"`

106582 

105861 - `output: optional string or null`106583 - `output: optional string or null`

105862 106584 

105863 The output from the tool call.106585 The output from the tool call.


107143 for reasoning items returned by `POST /v1/responses` and WebSocket107865 for reasoning items returned by `POST /v1/responses` and WebSocket

107144 `response.create` requests.107866 `response.create` requests.

107145 107867 

107868 When streaming, use the completed reasoning item and its

107869 `encrypted_content` from the `response.output_item.done` event in

107870 subsequent requests. The `encrypted_content` in

107871 `response.output_item.added` may be incomplete. This is especially

107872 important when `store` is `false` or when using Zero Data Retention.

107873 

107146 - `status: optional "in_progress" or "completed" or "incomplete"`107874 - `status: optional "in_progress" or "completed" or "incomplete"`

107147 107875 

107148 The status of the item. One of `in_progress`, `completed`, or107876 The status of the item. One of `in_progress`, `completed`, or


110020 Unique identifier for the MCP tool call approval request.110748 Unique identifier for the MCP tool call approval request.

110021 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.110749 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

110022 110750 

110023 - `error: optional string or null`110751 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

110752 

110753 The error from the tool call, if any.

110754 

110755 - `string`

110024 110756 

110025 The error from the tool call, if any.110757 The error from the tool call, if any.

110026 110758 

110759 - `McpProtocolError object { code, message, type }`

110760 

110761 - `code: number`

110762 

110763 - `message: string`

110764 

110765 - `type: "mcp_protocol_error"`

110766 

110767 - `"mcp_protocol_error"`

110768 

110769 - `McpToolExecutionError object { content, type }`

110770 

110771 - `content: unknown`

110772 

110773 - `type: "mcp_tool_execution_error"`

110774 

110775 - `"mcp_tool_execution_error"`

110776 

110777 - `HTTPError object { code, message, type }`

110778 

110779 - `code: number`

110780 

110781 - `message: string`

110782 

110783 - `type: "http_error"`

110784 

110785 - `"http_error"`

110786 

110027 - `output: optional string or null`110787 - `output: optional string or null`

110028 110788 

110029 The output from the tool call.110789 The output from the tool call.


115937 for reasoning items returned by `POST /v1/responses` and WebSocket116697 for reasoning items returned by `POST /v1/responses` and WebSocket

115938 `response.create` requests.116698 `response.create` requests.

115939 116699 

116700 When streaming, use the completed reasoning item and its

116701 `encrypted_content` from the `response.output_item.done` event in

116702 subsequent requests. The `encrypted_content` in

116703 `response.output_item.added` may be incomplete. This is especially

116704 important when `store` is `false` or when using Zero Data Retention.

116705 

115940 - `status: optional "in_progress" or "completed" or "incomplete"`116706 - `status: optional "in_progress" or "completed" or "incomplete"`

115941 116707 

115942 The status of the item. One of `in_progress`, `completed`, or116708 The status of the item. One of `in_progress`, `completed`, or


116710 Unique identifier for the MCP tool call approval request.117476 Unique identifier for the MCP tool call approval request.

116711 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.117477 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

116712 117478 

116713 - `error: optional string or null`117479 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

117480 

117481 The error from the tool call, if any.

117482 

117483 - `string`

116714 117484 

116715 The error from the tool call, if any.117485 The error from the tool call, if any.

116716 117486 

117487 - `McpProtocolError object { code, message, type }`

117488 

117489 - `code: number`

117490 

117491 - `message: string`

117492 

117493 - `type: "mcp_protocol_error"`

117494 

117495 - `"mcp_protocol_error"`

117496 

117497 - `McpToolExecutionError object { content, type }`

117498 

117499 - `content: unknown`

117500 

117501 - `type: "mcp_tool_execution_error"`

117502 

117503 - `"mcp_tool_execution_error"`

117504 

117505 - `HTTPError object { code, message, type }`

117506 

117507 - `code: number`

117508 

117509 - `message: string`

117510 

117511 - `type: "http_error"`

117512 

117513 - `"http_error"`

117514 

116717 - `output: optional string or null`117515 - `output: optional string or null`

116718 117516 

116719 The output from the tool call.117517 The output from the tool call.


117999 for reasoning items returned by `POST /v1/responses` and WebSocket118797 for reasoning items returned by `POST /v1/responses` and WebSocket

118000 `response.create` requests.118798 `response.create` requests.

118001 118799 

118800 When streaming, use the completed reasoning item and its

118801 `encrypted_content` from the `response.output_item.done` event in

118802 subsequent requests. The `encrypted_content` in

118803 `response.output_item.added` may be incomplete. This is especially

118804 important when `store` is `false` or when using Zero Data Retention.

118805 

118002 - `status: optional "in_progress" or "completed" or "incomplete"`118806 - `status: optional "in_progress" or "completed" or "incomplete"`

118003 118807 

118004 The status of the item. One of `in_progress`, `completed`, or118808 The status of the item. One of `in_progress`, `completed`, or


120876 Unique identifier for the MCP tool call approval request.121680 Unique identifier for the MCP tool call approval request.

120877 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.121681 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

120878 121682 

120879 - `error: optional string or null`121683 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

120880 121684 

120881 The error from the tool call, if any.121685 The error from the tool call, if any.

120882 121686 

121687 - `string`

121688 

121689 The error from the tool call, if any.

121690 

121691 - `McpProtocolError object { code, message, type }`

121692 

121693 - `code: number`

121694 

121695 - `message: string`

121696 

121697 - `type: "mcp_protocol_error"`

121698 

121699 - `"mcp_protocol_error"`

121700 

121701 - `McpToolExecutionError object { content, type }`

121702 

121703 - `content: unknown`

121704 

121705 - `type: "mcp_tool_execution_error"`

121706 

121707 - `"mcp_tool_execution_error"`

121708 

121709 - `HTTPError object { code, message, type }`

121710 

121711 - `code: number`

121712 

121713 - `message: string`

121714 

121715 - `type: "http_error"`

121716 

121717 - `"http_error"`

121718 

120883 - `output: optional string or null`121719 - `output: optional string or null`

120884 121720 

120885 The output from the tool call.121721 The output from the tool call.


126700 for reasoning items returned by `POST /v1/responses` and WebSocket127536 for reasoning items returned by `POST /v1/responses` and WebSocket

126701 `response.create` requests.127537 `response.create` requests.

126702 127538 

127539 When streaming, use the completed reasoning item and its

127540 `encrypted_content` from the `response.output_item.done` event in

127541 subsequent requests. The `encrypted_content` in

127542 `response.output_item.added` may be incomplete. This is especially

127543 important when `store` is `false` or when using Zero Data Retention.

127544 

126703 - `status: optional "in_progress" or "completed" or "incomplete"`127545 - `status: optional "in_progress" or "completed" or "incomplete"`

126704 127546 

126705 The status of the item. One of `in_progress`, `completed`, or127547 The status of the item. One of `in_progress`, `completed`, or


127473 Unique identifier for the MCP tool call approval request.128315 Unique identifier for the MCP tool call approval request.

127474 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.128316 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

127475 128317 

127476 - `error: optional string or null`128318 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

128319 

128320 The error from the tool call, if any.

128321 

128322 - `string`

127477 128323 

127478 The error from the tool call, if any.128324 The error from the tool call, if any.

127479 128325 

128326 - `McpProtocolError object { code, message, type }`

128327 

128328 - `code: number`

128329 

128330 - `message: string`

128331 

128332 - `type: "mcp_protocol_error"`

128333 

128334 - `"mcp_protocol_error"`

128335 

128336 - `McpToolExecutionError object { content, type }`

128337 

128338 - `content: unknown`

128339 

128340 - `type: "mcp_tool_execution_error"`

128341 

128342 - `"mcp_tool_execution_error"`

128343 

128344 - `HTTPError object { code, message, type }`

128345 

128346 - `code: number`

128347 

128348 - `message: string`

128349 

128350 - `type: "http_error"`

128351 

128352 - `"http_error"`

128353 

127480 - `output: optional string or null`128354 - `output: optional string or null`

127481 128355 

127482 The output from the tool call.128356 The output from the tool call.


131526 for reasoning items returned by `POST /v1/responses` and WebSocket132400 for reasoning items returned by `POST /v1/responses` and WebSocket

131527 `response.create` requests.132401 `response.create` requests.

131528 132402 

132403 When streaming, use the completed reasoning item and its

132404 `encrypted_content` from the `response.output_item.done` event in

132405 subsequent requests. The `encrypted_content` in

132406 `response.output_item.added` may be incomplete. This is especially

132407 important when `store` is `false` or when using Zero Data Retention.

132408 

131529 - `status: optional "in_progress" or "completed" or "incomplete"`132409 - `status: optional "in_progress" or "completed" or "incomplete"`

131530 132410 

131531 The status of the item. One of `in_progress`, `completed`, or132411 The status of the item. One of `in_progress`, `completed`, or


132299 Unique identifier for the MCP tool call approval request.133179 Unique identifier for the MCP tool call approval request.

132300 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.133180 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

132301 133181 

132302 - `error: optional string or null`133182 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

133183 

133184 The error from the tool call, if any.

133185 

133186 - `string`

132303 133187 

132304 The error from the tool call, if any.133188 The error from the tool call, if any.

132305 133189 

133190 - `McpProtocolError object { code, message, type }`

133191 

133192 - `code: number`

133193 

133194 - `message: string`

133195 

133196 - `type: "mcp_protocol_error"`

133197 

133198 - `"mcp_protocol_error"`

133199 

133200 - `McpToolExecutionError object { content, type }`

133201 

133202 - `content: unknown`

133203 

133204 - `type: "mcp_tool_execution_error"`

133205 

133206 - `"mcp_tool_execution_error"`

133207 

133208 - `HTTPError object { code, message, type }`

133209 

133210 - `code: number`

133211 

133212 - `message: string`

133213 

133214 - `type: "http_error"`

133215 

133216 - `"http_error"`

133217 

132306 - `output: optional string or null`133218 - `output: optional string or null`

132307 133219 

132308 The output from the tool call.133220 The output from the tool call.


134846 for reasoning items returned by `POST /v1/responses` and WebSocket135758 for reasoning items returned by `POST /v1/responses` and WebSocket

134847 `response.create` requests.135759 `response.create` requests.

134848 135760 

135761 When streaming, use the completed reasoning item and its

135762 `encrypted_content` from the `response.output_item.done` event in

135763 subsequent requests. The `encrypted_content` in

135764 `response.output_item.added` may be incomplete. This is especially

135765 important when `store` is `false` or when using Zero Data Retention.

135766 

134849 - `status: optional "in_progress" or "completed" or "incomplete"`135767 - `status: optional "in_progress" or "completed" or "incomplete"`

134850 135768 

134851 The status of the item. One of `in_progress`, `completed`, or135769 The status of the item. One of `in_progress`, `completed`, or


137873 Unique identifier for the MCP tool call approval request.138791 Unique identifier for the MCP tool call approval request.

137874 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.138792 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

137875 138793 

137876 - `error: optional string or null`138794 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

137877 138795 

137878 The error from the tool call, if any.138796 The error from the tool call, if any.

137879 138797 

138798 - `string`

138799 

138800 The error from the tool call, if any.

138801 

138802 - `McpProtocolError object { code, message, type }`

138803 

138804 - `code: number`

138805 

138806 - `message: string`

138807 

138808 - `type: "mcp_protocol_error"`

138809 

138810 - `"mcp_protocol_error"`

138811 

138812 - `McpToolExecutionError object { content, type }`

138813 

138814 - `content: unknown`

138815 

138816 - `type: "mcp_tool_execution_error"`

138817 

138818 - `"mcp_tool_execution_error"`

138819 

138820 - `HTTPError object { code, message, type }`

138821 

138822 - `code: number`

138823 

138824 - `message: string`

138825 

138826 - `type: "http_error"`

138827 

138828 - `"http_error"`

138829 

137880 - `output: optional string or null`138830 - `output: optional string or null`

137881 138831 

137882 The output from the tool call.138832 The output from the tool call.


138167 139117 

138168 - `item: BetaResponseOutputItem`139118 - `item: BetaResponseOutputItem`

138169 139119 

138170 The output item that was added.139120 The output item that was added. For reasoning items, `encrypted_content`

139121 may be incomplete while the item is in progress. Use the reasoning item

139122 from the corresponding `response.output_item.done` event when passing it

139123 as input to a subsequent request.

138171 139124 

138172 - `BetaResponseOutputMessage object { id, content, role, 4 more }`139125 - `BetaResponseOutputMessage object { id, content, role, 4 more }`

138173 139126 


139482 for reasoning items returned by `POST /v1/responses` and WebSocket140435 for reasoning items returned by `POST /v1/responses` and WebSocket

139483 `response.create` requests.140436 `response.create` requests.

139484 140437 

140438 When streaming, use the completed reasoning item and its

140439 `encrypted_content` from the `response.output_item.done` event in

140440 subsequent requests. The `encrypted_content` in

140441 `response.output_item.added` may be incomplete. This is especially

140442 important when `store` is `false` or when using Zero Data Retention.

140443 

139485 - `status: optional "in_progress" or "completed" or "incomplete"`140444 - `status: optional "in_progress" or "completed" or "incomplete"`

139486 140445 

139487 The status of the item. One of `in_progress`, `completed`, or140446 The status of the item. One of `in_progress`, `completed`, or


142509 Unique identifier for the MCP tool call approval request.143468 Unique identifier for the MCP tool call approval request.

142510 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.143469 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

142511 143470 

142512 - `error: optional string or null`143471 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

143472 

143473 The error from the tool call, if any.

143474 

143475 - `string`

142513 143476 

142514 The error from the tool call, if any.143477 The error from the tool call, if any.

142515 143478 

143479 - `McpProtocolError object { code, message, type }`

143480 

143481 - `code: number`

143482 

143483 - `message: string`

143484 

143485 - `type: "mcp_protocol_error"`

143486 

143487 - `"mcp_protocol_error"`

143488 

143489 - `McpToolExecutionError object { content, type }`

143490 

143491 - `content: unknown`

143492 

143493 - `type: "mcp_tool_execution_error"`

143494 

143495 - `"mcp_tool_execution_error"`

143496 

143497 - `HTTPError object { code, message, type }`

143498 

143499 - `code: number`

143500 

143501 - `message: string`

143502 

143503 - `type: "http_error"`

143504 

143505 - `"http_error"`

143506 

142516 - `output: optional string or null`143507 - `output: optional string or null`

142517 143508 

142518 The output from the tool call.143509 The output from the tool call.


144140 for reasoning items returned by `POST /v1/responses` and WebSocket145131 for reasoning items returned by `POST /v1/responses` and WebSocket

144141 `response.create` requests.145132 `response.create` requests.

144142 145133 

145134 When streaming, use the completed reasoning item and its

145135 `encrypted_content` from the `response.output_item.done` event in

145136 subsequent requests. The `encrypted_content` in

145137 `response.output_item.added` may be incomplete. This is especially

145138 important when `store` is `false` or when using Zero Data Retention.

145139 

144143 - `status: optional "in_progress" or "completed" or "incomplete"`145140 - `status: optional "in_progress" or "completed" or "incomplete"`

144144 145141 

144145 The status of the item. One of `in_progress`, `completed`, or145142 The status of the item. One of `in_progress`, `completed`, or


147167 Unique identifier for the MCP tool call approval request.148164 Unique identifier for the MCP tool call approval request.

147168 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.148165 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

147169 148166 

147170 - `error: optional string or null`148167 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

148168 

148169 The error from the tool call, if any.

148170 

148171 - `string`

147171 148172 

147172 The error from the tool call, if any.148173 The error from the tool call, if any.

147173 148174 

148175 - `McpProtocolError object { code, message, type }`

148176 

148177 - `code: number`

148178 

148179 - `message: string`

148180 

148181 - `type: "mcp_protocol_error"`

148182 

148183 - `"mcp_protocol_error"`

148184 

148185 - `McpToolExecutionError object { content, type }`

148186 

148187 - `content: unknown`

148188 

148189 - `type: "mcp_tool_execution_error"`

148190 

148191 - `"mcp_tool_execution_error"`

148192 

148193 - `HTTPError object { code, message, type }`

148194 

148195 - `code: number`

148196 

148197 - `message: string`

148198 

148199 - `type: "http_error"`

148200 

148201 - `"http_error"`

148202 

147174 - `output: optional string or null`148203 - `output: optional string or null`

147175 148204 

147176 The output from the tool call.148205 The output from the tool call.


147828 148857 

147829 Emitted when an annotation is added to output text content.148858 Emitted when an annotation is added to output text content.

147830 148859 

147831 - `annotation: unknown`148860 - `annotation: object { file_id, filename, index, type } or object { end_index, start_index, title, 2 more } or object { container_id, end_index, file_id, 3 more } or object { file_id, index, type } or null`

147832 148861 

147833 The annotation object being added. (See annotation schema for details.)148862 An annotation that applies to a span of output text.

148863 

148864 - `FileCitation object { file_id, filename, index, type }`

148865 

148866 A citation to a file.

148867 

148868 - `file_id: string`

148869 

148870 The ID of the file.

148871 

148872 - `filename: string`

148873 

148874 The filename of the file cited.

148875 

148876 - `index: number`

148877 

148878 The index of the file in the list of files.

148879 

148880 - `type: "file_citation"`

148881 

148882 The type of the file citation. Always `file_citation`.

148883 

148884 - `"file_citation"`

148885 

148886 - `URLCitation object { end_index, start_index, title, 2 more }`

148887 

148888 A citation for a web resource used to generate a model response.

148889 

148890 - `end_index: number`

148891 

148892 The index of the last character of the URL citation in the message.

148893 

148894 - `start_index: number`

148895 

148896 The index of the first character of the URL citation in the message.

148897 

148898 - `title: string`

148899 

148900 The title of the web resource.

148901 

148902 - `type: "url_citation"`

148903 

148904 The type of the URL citation. Always `url_citation`.

148905 

148906 - `"url_citation"`

148907 

148908 - `url: string`

148909 

148910 The URL of the web resource.

148911 

148912 - `ContainerFileCitation object { container_id, end_index, file_id, 3 more }`

148913 

148914 A citation for a container file used to generate a model response.

148915 

148916 - `container_id: string`

148917 

148918 The ID of the container file.

148919 

148920 - `end_index: number`

148921 

148922 The index of the last character of the container file citation in the message.

148923 

148924 - `file_id: string`

148925 

148926 The ID of the file.

148927 

148928 - `filename: string`

148929 

148930 The filename of the container file cited.

148931 

148932 - `start_index: number`

148933 

148934 The index of the first character of the container file citation in the message.

148935 

148936 - `type: "container_file_citation"`

148937 

148938 The type of the container file citation. Always `container_file_citation`.

148939 

148940 - `"container_file_citation"`

148941 

148942 - `FilePath object { file_id, index, type }`

148943 

148944 A path to a file.

148945 

148946 - `file_id: string`

148947 

148948 The ID of the file.

148949 

148950 - `index: number`

148951 

148952 The index of the file in the list of files.

148953 

148954 - `type: "file_path"`

148955 

148956 The type of the file path. Always `file_path`.

148957 

148958 - `"file_path"`

147834 148959 

147835 - `annotation_index: number`148960 - `annotation_index: number`

147836 148961 


151851 for reasoning items returned by `POST /v1/responses` and WebSocket152976 for reasoning items returned by `POST /v1/responses` and WebSocket

151852 `response.create` requests.152977 `response.create` requests.

151853 152978 

152979 When streaming, use the completed reasoning item and its

152980 `encrypted_content` from the `response.output_item.done` event in

152981 subsequent requests. The `encrypted_content` in

152982 `response.output_item.added` may be incomplete. This is especially

152983 important when `store` is `false` or when using Zero Data Retention.

152984 

151854 - `status: optional "in_progress" or "completed" or "incomplete"`152985 - `status: optional "in_progress" or "completed" or "incomplete"`

151855 152986 

151856 The status of the item. One of `in_progress`, `completed`, or152987 The status of the item. One of `in_progress`, `completed`, or


152624 Unique identifier for the MCP tool call approval request.153755 Unique identifier for the MCP tool call approval request.

152625 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.153756 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

152626 153757 

152627 - `error: optional string or null`153758 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

153759 

153760 The error from the tool call, if any.

153761 

153762 - `string`

152628 153763 

152629 The error from the tool call, if any.153764 The error from the tool call, if any.

152630 153765 

153766 - `McpProtocolError object { code, message, type }`

153767 

153768 - `code: number`

153769 

153770 - `message: string`

153771 

153772 - `type: "mcp_protocol_error"`

153773 

153774 - `"mcp_protocol_error"`

153775 

153776 - `McpToolExecutionError object { content, type }`

153777 

153778 - `content: unknown`

153779 

153780 - `type: "mcp_tool_execution_error"`

153781 

153782 - `"mcp_tool_execution_error"`

153783 

153784 - `HTTPError object { code, message, type }`

153785 

153786 - `code: number`

153787 

153788 - `message: string`

153789 

153790 - `type: "http_error"`

153791 

153792 - `"http_error"`

153793 

152631 - `output: optional string or null`153794 - `output: optional string or null`

152632 153795 

152633 The output from the tool call.153796 The output from the tool call.


153913 for reasoning items returned by `POST /v1/responses` and WebSocket155076 for reasoning items returned by `POST /v1/responses` and WebSocket

153914 `response.create` requests.155077 `response.create` requests.

153915 155078 

155079 When streaming, use the completed reasoning item and its

155080 `encrypted_content` from the `response.output_item.done` event in

155081 subsequent requests. The `encrypted_content` in

155082 `response.output_item.added` may be incomplete. This is especially

155083 important when `store` is `false` or when using Zero Data Retention.

155084 

153916 - `status: optional "in_progress" or "completed" or "incomplete"`155085 - `status: optional "in_progress" or "completed" or "incomplete"`

153917 155086 

153918 The status of the item. One of `in_progress`, `completed`, or155087 The status of the item. One of `in_progress`, `completed`, or


156790 Unique identifier for the MCP tool call approval request.157959 Unique identifier for the MCP tool call approval request.

156791 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.157960 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

156792 157961 

156793 - `error: optional string or null`157962 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

157963 

157964 The error from the tool call, if any.

157965 

157966 - `string`

156794 157967 

156795 The error from the tool call, if any.157968 The error from the tool call, if any.

156796 157969 

157970 - `McpProtocolError object { code, message, type }`

157971 

157972 - `code: number`

157973 

157974 - `message: string`

157975 

157976 - `type: "mcp_protocol_error"`

157977 

157978 - `"mcp_protocol_error"`

157979 

157980 - `McpToolExecutionError object { content, type }`

157981 

157982 - `content: unknown`

157983 

157984 - `type: "mcp_tool_execution_error"`

157985 

157986 - `"mcp_tool_execution_error"`

157987 

157988 - `HTTPError object { code, message, type }`

157989 

157990 - `code: number`

157991 

157992 - `message: string`

157993 

157994 - `type: "http_error"`

157995 

157996 - `"http_error"`

157997 

156797 - `output: optional string or null`157998 - `output: optional string or null`

156798 157999 

156799 The output from the tool call.158000 The output from the tool call.


163300 for reasoning items returned by `POST /v1/responses` and WebSocket164501 for reasoning items returned by `POST /v1/responses` and WebSocket

163301 `response.create` requests.164502 `response.create` requests.

163302 164503 

164504 When streaming, use the completed reasoning item and its

164505 `encrypted_content` from the `response.output_item.done` event in

164506 subsequent requests. The `encrypted_content` in

164507 `response.output_item.added` may be incomplete. This is especially

164508 important when `store` is `false` or when using Zero Data Retention.

164509 

163303 - `status: optional "in_progress" or "completed" or "incomplete"`164510 - `status: optional "in_progress" or "completed" or "incomplete"`

163304 164511 

163305 The status of the item. One of `in_progress`, `completed`, or164512 The status of the item. One of `in_progress`, `completed`, or


164073 Unique identifier for the MCP tool call approval request.165280 Unique identifier for the MCP tool call approval request.

164074 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.165281 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

164075 165282 

164076 - `error: optional string or null`165283 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

165284 

165285 The error from the tool call, if any.

165286 

165287 - `string`

164077 165288 

164078 The error from the tool call, if any.165289 The error from the tool call, if any.

164079 165290 

165291 - `McpProtocolError object { code, message, type }`

165292 

165293 - `code: number`

165294 

165295 - `message: string`

165296 

165297 - `type: "mcp_protocol_error"`

165298 

165299 - `"mcp_protocol_error"`

165300 

165301 - `McpToolExecutionError object { content, type }`

165302 

165303 - `content: unknown`

165304 

165305 - `type: "mcp_tool_execution_error"`

165306 

165307 - `"mcp_tool_execution_error"`

165308 

165309 - `HTTPError object { code, message, type }`

165310 

165311 - `code: number`

165312 

165313 - `message: string`

165314 

165315 - `type: "http_error"`

165316 

165317 - `"http_error"`

165318 

164080 - `output: optional string or null`165319 - `output: optional string or null`

164081 165320 

164082 The output from the tool call.165321 The output from the tool call.


165362 for reasoning items returned by `POST /v1/responses` and WebSocket166601 for reasoning items returned by `POST /v1/responses` and WebSocket

165363 `response.create` requests.166602 `response.create` requests.

165364 166603 

166604 When streaming, use the completed reasoning item and its

166605 `encrypted_content` from the `response.output_item.done` event in

166606 subsequent requests. The `encrypted_content` in

166607 `response.output_item.added` may be incomplete. This is especially

166608 important when `store` is `false` or when using Zero Data Retention.

166609 

165365 - `status: optional "in_progress" or "completed" or "incomplete"`166610 - `status: optional "in_progress" or "completed" or "incomplete"`

165366 166611 

165367 The status of the item. One of `in_progress`, `completed`, or166612 The status of the item. One of `in_progress`, `completed`, or


168239 Unique identifier for the MCP tool call approval request.169484 Unique identifier for the MCP tool call approval request.

168240 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.169485 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

168241 169486 

168242 - `error: optional string or null`169487 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

168243 169488 

168244 The error from the tool call, if any.169489 The error from the tool call, if any.

168245 169490 

169491 - `string`

169492 

169493 The error from the tool call, if any.

169494 

169495 - `McpProtocolError object { code, message, type }`

169496 

169497 - `code: number`

169498 

169499 - `message: string`

169500 

169501 - `type: "mcp_protocol_error"`

169502 

169503 - `"mcp_protocol_error"`

169504 

169505 - `McpToolExecutionError object { content, type }`

169506 

169507 - `content: unknown`

169508 

169509 - `type: "mcp_tool_execution_error"`

169510 

169511 - `"mcp_tool_execution_error"`

169512 

169513 - `HTTPError object { code, message, type }`

169514 

169515 - `code: number`

169516 

169517 - `message: string`

169518 

169519 - `type: "http_error"`

169520 

169521 - `"http_error"`

169522 

168246 - `output: optional string or null`169523 - `output: optional string or null`

168247 169524 

168248 The output from the tool call.169525 The output from the tool call.


170697 171974 

170698 - `item: BetaResponseOutputItem`171975 - `item: BetaResponseOutputItem`

170699 171976 

170700 The output item that was added.171977 The output item that was added. For reasoning items, `encrypted_content`

171978 may be incomplete while the item is in progress. Use the reasoning item

171979 from the corresponding `response.output_item.done` event when passing it

171980 as input to a subsequent request.

170701 171981 

170702 - `BetaResponseOutputMessage object { id, content, role, 4 more }`171982 - `BetaResponseOutputMessage object { id, content, role, 4 more }`

170703 171983 


171785 173065 

171786 Emitted when an annotation is added to output text content.173066 Emitted when an annotation is added to output text content.

171787 173067 

171788 - `annotation: unknown`173068 - `annotation: object { file_id, filename, index, type } or object { end_index, start_index, title, 2 more } or object { container_id, end_index, file_id, 3 more } or object { file_id, index, type } or null`

173069 

173070 An annotation that applies to a span of output text.

173071 

173072 - `FileCitation object { file_id, filename, index, type }`

173073 

173074 A citation to a file.

173075 

173076 - `file_id: string`

173077 

173078 The ID of the file.

173079 

173080 - `filename: string`

173081 

173082 The filename of the file cited.

173083 

173084 - `index: number`

173085 

173086 The index of the file in the list of files.

173087 

173088 - `type: "file_citation"`

173089 

173090 The type of the file citation. Always `file_citation`.

173091 

173092 - `"file_citation"`

173093 

173094 - `URLCitation object { end_index, start_index, title, 2 more }`

173095 

173096 A citation for a web resource used to generate a model response.

173097 

173098 - `end_index: number`

173099 

173100 The index of the last character of the URL citation in the message.

173101 

173102 - `start_index: number`

173103 

173104 The index of the first character of the URL citation in the message.

173105 

173106 - `title: string`

173107 

173108 The title of the web resource.

173109 

173110 - `type: "url_citation"`

173111 

173112 The type of the URL citation. Always `url_citation`.

173113 

173114 - `"url_citation"`

173115 

173116 - `url: string`

173117 

173118 The URL of the web resource.

173119 

173120 - `ContainerFileCitation object { container_id, end_index, file_id, 3 more }`

173121 

173122 A citation for a container file used to generate a model response.

173123 

173124 - `container_id: string`

173125 

173126 The ID of the container file.

173127 

173128 - `end_index: number`

173129 

173130 The index of the last character of the container file citation in the message.

173131 

173132 - `file_id: string`

173133 

173134 The ID of the file.

173135 

173136 - `filename: string`

173137 

173138 The filename of the container file cited.

173139 

173140 - `start_index: number`

173141 

173142 The index of the first character of the container file citation in the message.

173143 

173144 - `type: "container_file_citation"`

173145 

173146 The type of the container file citation. Always `container_file_citation`.

173147 

173148 - `"container_file_citation"`

173149 

173150 - `FilePath object { file_id, index, type }`

171789 173151 

171790 The annotation object being added. (See annotation schema for details.)173152 A path to a file.

173153 

173154 - `file_id: string`

173155 

173156 The ID of the file.

173157 

173158 - `index: number`

173159 

173160 The index of the file in the list of files.

173161 

173162 - `type: "file_path"`

173163 

173164 The type of the file path. Always `file_path`.

173165 

173166 - `"file_path"`

171791 173167 

171792 - `annotation_index: number`173168 - `annotation_index: number`

171793 173169 


176137 for reasoning items returned by `POST /v1/responses` and WebSocket177513 for reasoning items returned by `POST /v1/responses` and WebSocket

176138 `response.create` requests.177514 `response.create` requests.

176139 177515 

177516 When streaming, use the completed reasoning item and its

177517 `encrypted_content` from the `response.output_item.done` event in

177518 subsequent requests. The `encrypted_content` in

177519 `response.output_item.added` may be incomplete. This is especially

177520 important when `store` is `false` or when using Zero Data Retention.

177521 

176140 - `status: optional "in_progress" or "completed" or "incomplete"`177522 - `status: optional "in_progress" or "completed" or "incomplete"`

176141 177523 

176142 The status of the item. One of `in_progress`, `completed`, or177524 The status of the item. One of `in_progress`, `completed`, or


176910 Unique identifier for the MCP tool call approval request.178292 Unique identifier for the MCP tool call approval request.

176911 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.178293 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

176912 178294 

176913 - `error: optional string or null`178295 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

178296 

178297 The error from the tool call, if any.

178298 

178299 - `string`

176914 178300 

176915 The error from the tool call, if any.178301 The error from the tool call, if any.

176916 178302 

178303 - `McpProtocolError object { code, message, type }`

178304 

178305 - `code: number`

178306 

178307 - `message: string`

178308 

178309 - `type: "mcp_protocol_error"`

178310 

178311 - `"mcp_protocol_error"`

178312 

178313 - `McpToolExecutionError object { content, type }`

178314 

178315 - `content: unknown`

178316 

178317 - `type: "mcp_tool_execution_error"`

178318 

178319 - `"mcp_tool_execution_error"`

178320 

178321 - `HTTPError object { code, message, type }`

178322 

178323 - `code: number`

178324 

178325 - `message: string`

178326 

178327 - `type: "http_error"`

178328 

178329 - `"http_error"`

178330 

176917 - `output: optional string or null`178331 - `output: optional string or null`

176918 178332 

176919 The output from the tool call.178333 The output from the tool call.


181952 for reasoning items returned by `POST /v1/responses` and WebSocket183366 for reasoning items returned by `POST /v1/responses` and WebSocket

181953 `response.create` requests.183367 `response.create` requests.

181954 183368 

183369 When streaming, use the completed reasoning item and its

183370 `encrypted_content` from the `response.output_item.done` event in

183371 subsequent requests. The `encrypted_content` in

183372 `response.output_item.added` may be incomplete. This is especially

183373 important when `store` is `false` or when using Zero Data Retention.

183374 

181955 - `status: optional "in_progress" or "completed" or "incomplete"`183375 - `status: optional "in_progress" or "completed" or "incomplete"`

181956 183376 

181957 The status of the item. One of `in_progress`, `completed`, or183377 The status of the item. One of `in_progress`, `completed`, or


182701 Unique identifier for the MCP tool call approval request.184121 Unique identifier for the MCP tool call approval request.

182702 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.184122 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

182703 184123 

182704 - `error: optional string or null`184124 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

182705 184125 

182706 The error from the tool call, if any.184126 The error from the tool call, if any.

182707 184127 

184128 - `string`

184129 

184130 The error from the tool call, if any.

184131 

184132 - `McpProtocolError object { code, message, type }`

184133 

184134 - `code: number`

184135 

184136 - `message: string`

184137 

184138 - `type: "mcp_protocol_error"`

184139 

184140 - `"mcp_protocol_error"`

184141 

184142 - `McpToolExecutionError object { content, type }`

184143 

184144 - `content: unknown`

184145 

184146 - `type: "mcp_tool_execution_error"`

184147 

184148 - `"mcp_tool_execution_error"`

184149 

184150 - `HTTPError object { code, message, type }`

184151 

184152 - `code: number`

184153 

184154 - `message: string`

184155 

184156 - `type: "http_error"`

184157 

184158 - `"http_error"`

184159 

182708 - `output: optional string or null`184160 - `output: optional string or null`

182709 184161 

182710 The output from the tool call.184162 The output from the tool call.


183110 when the originating `response.create` event supplied a184562 when the originating `response.create` event supplied a

183111 `stream_id`.184563 `stream_id`.

183112 184564 

183113 - `BetaResponseWsError = BetaResponseErrorEvent`

183114 

183115 Emitted when an error occurs.

183116 

183117 - `stream_id: optional string`

183118 

183119 The WebSocket lane that emitted this event. This field is present

183120 when the originating `response.create` event supplied a

183121 `stream_id`.

183122 

183123 - `BetaResponseFileSearchCallWsCompleted = BetaResponseFileSearchCallCompletedEvent`184565 - `BetaResponseFileSearchCallWsCompleted = BetaResponseFileSearchCallCompletedEvent`

183124 184566 

183125 Emitted when a file search call is completed (results found).184567 Emitted when a file search call is completed (results found).


183510 when the originating `response.create` event supplied a184952 when the originating `response.create` event supplied a

183511 `stream_id`.184953 `stream_id`.

183512 184954 

184955 - `BetaResponseWsError object { error, type, agent, 3 more }`

184956 

184957 Emitted when an error occurs while processing a Responses WebSocket request.

184958 

184959 - `error: object { code, message, param, 2 more }`

184960 

184961 Details about the error.

184962 

184963 - `code: string or null`

184964 

184965 The error code that was emitted, if any.

184966 

184967 - `message: string`

184968 

184969 The human-readable error message that was emitted.

184970 

184971 - `param: string or null`

184972 

184973 The parameter name that was associated with the error, if any.

184974 

184975 - `type: string`

184976 

184977 The error type that was emitted.

184978 

184979 - `headers: optional map[string]`

184980 

184981 The response headers that were emitted with the error, if any.

184982 

184983 - `type: "error"`

184984 

184985 The type of the event. Always `error`.

184986 

184987 - `"error"`

184988 

184989 - `agent: optional object { agent_name } or null`

184990 

184991 The agent that owns this multi-agent streaming event.

184992 

184993 - `agent_name: string`

184994 

184995 The canonical name of the agent that produced this item.

184996 

184997 - `sequence_number: optional number`

184998 

184999 The sequence number of an error emitted by the response stream.

185000 

185001 - `status: optional number`

185002 

185003 The HTTP status code associated with a WebSocket protocol error.

185004 

185005 - `stream_id: optional string`

185006 

185007 The WebSocket lane that emitted this event. This field is present when the

185008 originating `response.create` event supplied a `stream_id`.

185009 

183513 - `BetaResponseInjectCreatedEvent object { response_id, sequence_number, type, stream_id }`185010 - `BetaResponseInjectCreatedEvent object { response_id, sequence_number, type, stream_id }`

183514 185011 

183515 Emitted when all injected input items were validated and committed to the185012 Emitted when all injected input items were validated and committed to the


187312 for reasoning items returned by `POST /v1/responses` and WebSocket188809 for reasoning items returned by `POST /v1/responses` and WebSocket

187313 `response.create` requests.188810 `response.create` requests.

187314 188811 

188812 When streaming, use the completed reasoning item and its

188813 `encrypted_content` from the `response.output_item.done` event in

188814 subsequent requests. The `encrypted_content` in

188815 `response.output_item.added` may be incomplete. This is especially

188816 important when `store` is `false` or when using Zero Data Retention.

188817 

187315 - `status: optional "in_progress" or "completed" or "incomplete"`188818 - `status: optional "in_progress" or "completed" or "incomplete"`

187316 188819 

187317 The status of the item. One of `in_progress`, `completed`, or188820 The status of the item. One of `in_progress`, `completed`, or


188085 Unique identifier for the MCP tool call approval request.189588 Unique identifier for the MCP tool call approval request.

188086 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.189589 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

188087 189590 

188088 - `error: optional string or null`189591 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

189592 

189593 The error from the tool call, if any.

189594 

189595 - `string`

188089 189596 

188090 The error from the tool call, if any.189597 The error from the tool call, if any.

188091 189598 

189599 - `McpProtocolError object { code, message, type }`

189600 

189601 - `code: number`

189602 

189603 - `message: string`

189604 

189605 - `type: "mcp_protocol_error"`

189606 

189607 - `"mcp_protocol_error"`

189608 

189609 - `McpToolExecutionError object { content, type }`

189610 

189611 - `content: unknown`

189612 

189613 - `type: "mcp_tool_execution_error"`

189614 

189615 - `"mcp_tool_execution_error"`

189616 

189617 - `HTTPError object { code, message, type }`

189618 

189619 - `code: number`

189620 

189621 - `message: string`

189622 

189623 - `type: "http_error"`

189624 

189625 - `"http_error"`

189626 

188092 - `output: optional string or null`189627 - `output: optional string or null`

188093 189628 

188094 The output from the tool call.189629 The output from the tool call.


192280 for reasoning items returned by `POST /v1/responses` and WebSocket193815 for reasoning items returned by `POST /v1/responses` and WebSocket

192281 `response.create` requests.193816 `response.create` requests.

192282 193817 

193818 When streaming, use the completed reasoning item and its

193819 `encrypted_content` from the `response.output_item.done` event in

193820 subsequent requests. The `encrypted_content` in

193821 `response.output_item.added` may be incomplete. This is especially

193822 important when `store` is `false` or when using Zero Data Retention.

193823 

192283 - `status: optional "in_progress" or "completed" or "incomplete"`193824 - `status: optional "in_progress" or "completed" or "incomplete"`

192284 193825 

192285 The status of the item. One of `in_progress`, `completed`, or193826 The status of the item. One of `in_progress`, `completed`, or


193145 Unique identifier for the MCP tool call approval request.194686 Unique identifier for the MCP tool call approval request.

193146 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.194687 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

193147 194688 

193148 - `error: optional string or null`194689 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

194690 

194691 The error from the tool call, if any.

194692 

194693 - `string`

193149 194694 

193150 The error from the tool call, if any.194695 The error from the tool call, if any.

193151 194696 

194697 - `McpProtocolError object { code, message, type }`

194698 

194699 - `code: number`

194700 

194701 - `message: string`

194702 

194703 - `type: "mcp_protocol_error"`

194704 

194705 - `"mcp_protocol_error"`

194706 

194707 - `McpToolExecutionError object { content, type }`

194708 

194709 - `content: unknown`

194710 

194711 - `type: "mcp_tool_execution_error"`

194712 

194713 - `"mcp_tool_execution_error"`

194714 

194715 - `HTTPError object { code, message, type }`

194716 

194717 - `code: number`

194718 

194719 - `message: string`

194720 

194721 - `type: "http_error"`

194722 

194723 - `"http_error"`

194724 

193152 - `output: optional string or null`194725 - `output: optional string or null`

193153 194726 

193154 The output from the tool call.194727 The output from the tool call.


197078 for reasoning items returned by `POST /v1/responses` and WebSocket198651 for reasoning items returned by `POST /v1/responses` and WebSocket

197079 `response.create` requests.198652 `response.create` requests.

197080 198653 

198654 When streaming, use the completed reasoning item and its

198655 `encrypted_content` from the `response.output_item.done` event in

198656 subsequent requests. The `encrypted_content` in

198657 `response.output_item.added` may be incomplete. This is especially

198658 important when `store` is `false` or when using Zero Data Retention.

198659 

197081 - `status: optional "in_progress" or "completed" or "incomplete"`198660 - `status: optional "in_progress" or "completed" or "incomplete"`

197082 198661 

197083 The status of the item. One of `in_progress`, `completed`, or198662 The status of the item. One of `in_progress`, `completed`, or


197943 Unique identifier for the MCP tool call approval request.199522 Unique identifier for the MCP tool call approval request.

197944 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.199523 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

197945 199524 

197946 - `error: optional string or null`199525 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

199526 

199527 The error from the tool call, if any.

199528 

199529 - `string`

197947 199530 

197948 The error from the tool call, if any.199531 The error from the tool call, if any.

197949 199532 

199533 - `McpProtocolError object { code, message, type }`

199534 

199535 - `code: number`

199536 

199537 - `message: string`

199538 

199539 - `type: "mcp_protocol_error"`

199540 

199541 - `"mcp_protocol_error"`

199542 

199543 - `McpToolExecutionError object { content, type }`

199544 

199545 - `content: unknown`

199546 

199547 - `type: "mcp_tool_execution_error"`

199548 

199549 - `"mcp_tool_execution_error"`

199550 

199551 - `HTTPError object { code, message, type }`

199552 

199553 - `code: number`

199554 

199555 - `message: string`

199556 

199557 - `type: "http_error"`

199558 

199559 - `"http_error"`

199560 

197950 - `output: optional string or null`199561 - `output: optional string or null`

197951 199562 

197952 The output from the tool call.199563 The output from the tool call.


201941 for reasoning items returned by `POST /v1/responses` and WebSocket203552 for reasoning items returned by `POST /v1/responses` and WebSocket

201942 `response.create` requests.203553 `response.create` requests.

201943 203554 

203555 When streaming, use the completed reasoning item and its

203556 `encrypted_content` from the `response.output_item.done` event in

203557 subsequent requests. The `encrypted_content` in

203558 `response.output_item.added` may be incomplete. This is especially

203559 important when `store` is `false` or when using Zero Data Retention.

203560 

201944 - `status: optional "in_progress" or "completed" or "incomplete"`203561 - `status: optional "in_progress" or "completed" or "incomplete"`

201945 203562 

201946 The status of the item. One of `in_progress`, `completed`, or203563 The status of the item. One of `in_progress`, `completed`, or


202714 Unique identifier for the MCP tool call approval request.204331 Unique identifier for the MCP tool call approval request.

202715 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.204332 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

202716 204333 

202717 - `error: optional string or null`204334 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

204335 

204336 The error from the tool call, if any.

204337 

204338 - `string`

202718 204339 

202719 The error from the tool call, if any.204340 The error from the tool call, if any.

202720 204341 

204342 - `McpProtocolError object { code, message, type }`

204343 

204344 - `code: number`

204345 

204346 - `message: string`

204347 

204348 - `type: "mcp_protocol_error"`

204349 

204350 - `"mcp_protocol_error"`

204351 

204352 - `McpToolExecutionError object { content, type }`

204353 

204354 - `content: unknown`

204355 

204356 - `type: "mcp_tool_execution_error"`

204357 

204358 - `"mcp_tool_execution_error"`

204359 

204360 - `HTTPError object { code, message, type }`

204361 

204362 - `code: number`

204363 

204364 - `message: string`

204365 

204366 - `type: "http_error"`

204367 

204368 - `"http_error"`

204369 

202721 - `output: optional string or null`204370 - `output: optional string or null`

202722 204371 

202723 The output from the tool call.204372 The output from the tool call.

Details

3862 for reasoning items returned by `POST /v1/responses` and WebSocket3862 for reasoning items returned by `POST /v1/responses` and WebSocket

3863 `response.create` requests.3863 `response.create` requests.

3864 3864 

3865 When streaming, use the completed reasoning item and its

3866 `encrypted_content` from the `response.output_item.done` event in

3867 subsequent requests. The `encrypted_content` in

3868 `response.output_item.added` may be incomplete. This is especially

3869 important when `store` is `false` or when using Zero Data Retention.

3870 

3865 - `status: optional "in_progress" or "completed" or "incomplete"`3871 - `status: optional "in_progress" or "completed" or "incomplete"`

3866 3872 

3867 The status of the item. One of `in_progress`, `completed`, or3873 The status of the item. One of `in_progress`, `completed`, or


4635 Unique identifier for the MCP tool call approval request.4641 Unique identifier for the MCP tool call approval request.

4636 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.4642 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

4637 4643 

4638 - `error: optional string or null`4644 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

4645 

4646 The error from the tool call, if any.

4647 

4648 - `string`

4639 4649 

4640 The error from the tool call, if any.4650 The error from the tool call, if any.

4641 4651 

4652 - `McpProtocolError object { code, message, type }`

4653 

4654 - `code: number`

4655 

4656 - `message: string`

4657 

4658 - `type: "mcp_protocol_error"`

4659 

4660 - `"mcp_protocol_error"`

4661 

4662 - `McpToolExecutionError object { content, type }`

4663 

4664 - `content: unknown`

4665 

4666 - `type: "mcp_tool_execution_error"`

4667 

4668 - `"mcp_tool_execution_error"`

4669 

4670 - `HTTPError object { code, message, type }`

4671 

4672 - `code: number`

4673 

4674 - `message: string`

4675 

4676 - `type: "http_error"`

4677 

4678 - `"http_error"`

4679 

4642 - `output: optional string or null`4680 - `output: optional string or null`

4643 4681 

4644 The output from the tool call.4682 The output from the tool call.


5924 for reasoning items returned by `POST /v1/responses` and WebSocket5962 for reasoning items returned by `POST /v1/responses` and WebSocket

5925 `response.create` requests.5963 `response.create` requests.

5926 5964 

5965 When streaming, use the completed reasoning item and its

5966 `encrypted_content` from the `response.output_item.done` event in

5967 subsequent requests. The `encrypted_content` in

5968 `response.output_item.added` may be incomplete. This is especially

5969 important when `store` is `false` or when using Zero Data Retention.

5970 

5927 - `status: optional "in_progress" or "completed" or "incomplete"`5971 - `status: optional "in_progress" or "completed" or "incomplete"`

5928 5972 

5929 The status of the item. One of `in_progress`, `completed`, or5973 The status of the item. One of `in_progress`, `completed`, or


8801 Unique identifier for the MCP tool call approval request.8845 Unique identifier for the MCP tool call approval request.

8802 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.8846 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

8803 8847 

8804 - `error: optional string or null`8848 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

8849 

8850 The error from the tool call, if any.

8851 

8852 - `string`

8805 8853 

8806 The error from the tool call, if any.8854 The error from the tool call, if any.

8807 8855 

8856 - `McpProtocolError object { code, message, type }`

8857 

8858 - `code: number`

8859 

8860 - `message: string`

8861 

8862 - `type: "mcp_protocol_error"`

8863 

8864 - `"mcp_protocol_error"`

8865 

8866 - `McpToolExecutionError object { content, type }`

8867 

8868 - `content: unknown`

8869 

8870 - `type: "mcp_tool_execution_error"`

8871 

8872 - `"mcp_tool_execution_error"`

8873 

8874 - `HTTPError object { code, message, type }`

8875 

8876 - `code: number`

8877 

8878 - `message: string`

8879 

8880 - `type: "http_error"`

8881 

8882 - `"http_error"`

8883 

8808 - `output: optional string or null`8884 - `output: optional string or null`

8809 8885 

8810 The output from the tool call.8886 The output from the tool call.

Details

3992 for reasoning items returned by `POST /v1/responses` and WebSocket3992 for reasoning items returned by `POST /v1/responses` and WebSocket

3993 `response.create` requests.3993 `response.create` requests.

3994 3994 

3995 When streaming, use the completed reasoning item and its

3996 `encrypted_content` from the `response.output_item.done` event in

3997 subsequent requests. The `encrypted_content` in

3998 `response.output_item.added` may be incomplete. This is especially

3999 important when `store` is `false` or when using Zero Data Retention.

4000 

3995 - `status: optional "in_progress" or "completed" or "incomplete"`4001 - `status: optional "in_progress" or "completed" or "incomplete"`

3996 4002 

3997 The status of the item. One of `in_progress`, `completed`, or4003 The status of the item. One of `in_progress`, `completed`, or


4765 Unique identifier for the MCP tool call approval request.4771 Unique identifier for the MCP tool call approval request.

4766 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.4772 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

4767 4773 

4768 - `error: optional string or null`4774 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

4775 

4776 The error from the tool call, if any.

4777 

4778 - `string`

4769 4779 

4770 The error from the tool call, if any.4780 The error from the tool call, if any.

4771 4781 

4782 - `McpProtocolError object { code, message, type }`

4783 

4784 - `code: number`

4785 

4786 - `message: string`

4787 

4788 - `type: "mcp_protocol_error"`

4789 

4790 - `"mcp_protocol_error"`

4791 

4792 - `McpToolExecutionError object { content, type }`

4793 

4794 - `content: unknown`

4795 

4796 - `type: "mcp_tool_execution_error"`

4797 

4798 - `"mcp_tool_execution_error"`

4799 

4800 - `HTTPError object { code, message, type }`

4801 

4802 - `code: number`

4803 

4804 - `message: string`

4805 

4806 - `type: "http_error"`

4807 

4808 - `"http_error"`

4809 

4772 - `output: optional string or null`4810 - `output: optional string or null`

4773 4811 

4774 The output from the tool call.4812 The output from the tool call.


8917 for reasoning items returned by `POST /v1/responses` and WebSocket8955 for reasoning items returned by `POST /v1/responses` and WebSocket

8918 `response.create` requests.8956 `response.create` requests.

8919 8957 

8958 When streaming, use the completed reasoning item and its

8959 `encrypted_content` from the `response.output_item.done` event in

8960 subsequent requests. The `encrypted_content` in

8961 `response.output_item.added` may be incomplete. This is especially

8962 important when `store` is `false` or when using Zero Data Retention.

8963 

8920 - `status: optional "in_progress" or "completed" or "incomplete"`8964 - `status: optional "in_progress" or "completed" or "incomplete"`

8921 8965 

8922 The status of the item. One of `in_progress`, `completed`, or8966 The status of the item. One of `in_progress`, `completed`, or


9676 Unique identifier for the MCP tool call approval request.9720 Unique identifier for the MCP tool call approval request.

9677 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.9721 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

9678 9722 

9679 - `error: optional string or null`9723 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

9724 

9725 The error from the tool call, if any.

9726 

9727 - `string`

9680 9728 

9681 The error from the tool call, if any.9729 The error from the tool call, if any.

9682 9730 

9731 - `McpProtocolError object { code, message, type }`

9732 

9733 - `code: number`

9734 

9735 - `message: string`

9736 

9737 - `type: "mcp_protocol_error"`

9738 

9739 - `"mcp_protocol_error"`

9740 

9741 - `McpToolExecutionError object { content, type }`

9742 

9743 - `content: unknown`

9744 

9745 - `type: "mcp_tool_execution_error"`

9746 

9747 - `"mcp_tool_execution_error"`

9748 

9749 - `HTTPError object { code, message, type }`

9750 

9751 - `code: number`

9752 

9753 - `message: string`

9754 

9755 - `type: "http_error"`

9756 

9757 - `"http_error"`

9758 

9683 - `output: optional string or null`9759 - `output: optional string or null`

9684 9760 

9685 The output from the tool call.9761 The output from the tool call.

Details

3854 for reasoning items returned by `POST /v1/responses` and WebSocket3854 for reasoning items returned by `POST /v1/responses` and WebSocket

3855 `response.create` requests.3855 `response.create` requests.

3856 3856 

3857 When streaming, use the completed reasoning item and its

3858 `encrypted_content` from the `response.output_item.done` event in

3859 subsequent requests. The `encrypted_content` in

3860 `response.output_item.added` may be incomplete. This is especially

3861 important when `store` is `false` or when using Zero Data Retention.

3862 

3857 - `status: optional "in_progress" or "completed" or "incomplete"`3863 - `status: optional "in_progress" or "completed" or "incomplete"`

3858 3864 

3859 The status of the item. One of `in_progress`, `completed`, or3865 The status of the item. One of `in_progress`, `completed`, or


4627 Unique identifier for the MCP tool call approval request.4633 Unique identifier for the MCP tool call approval request.

4628 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.4634 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

4629 4635 

4630 - `error: optional string or null`4636 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

4631 4637 

4632 The error from the tool call, if any.4638 The error from the tool call, if any.

4633 4639 

4640 - `string`

4641 

4642 The error from the tool call, if any.

4643 

4644 - `McpProtocolError object { code, message, type }`

4645 

4646 - `code: number`

4647 

4648 - `message: string`

4649 

4650 - `type: "mcp_protocol_error"`

4651 

4652 - `"mcp_protocol_error"`

4653 

4654 - `McpToolExecutionError object { content, type }`

4655 

4656 - `content: unknown`

4657 

4658 - `type: "mcp_tool_execution_error"`

4659 

4660 - `"mcp_tool_execution_error"`

4661 

4662 - `HTTPError object { code, message, type }`

4663 

4664 - `code: number`

4665 

4666 - `message: string`

4667 

4668 - `type: "http_error"`

4669 

4670 - `"http_error"`

4671 

4634 - `output: optional string or null`4672 - `output: optional string or null`

4635 4673 

4636 The output from the tool call.4674 The output from the tool call.


10579 for reasoning items returned by `POST /v1/responses` and WebSocket10617 for reasoning items returned by `POST /v1/responses` and WebSocket

10580 `response.create` requests.10618 `response.create` requests.

10581 10619 

10620 When streaming, use the completed reasoning item and its

10621 `encrypted_content` from the `response.output_item.done` event in

10622 subsequent requests. The `encrypted_content` in

10623 `response.output_item.added` may be incomplete. This is especially

10624 important when `store` is `false` or when using Zero Data Retention.

10625 

10582 - `status: optional "in_progress" or "completed" or "incomplete"`10626 - `status: optional "in_progress" or "completed" or "incomplete"`

10583 10627 

10584 The status of the item. One of `in_progress`, `completed`, or10628 The status of the item. One of `in_progress`, `completed`, or


11352 Unique identifier for the MCP tool call approval request.11396 Unique identifier for the MCP tool call approval request.

11353 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.11397 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

11354 11398 

11355 - `error: optional string or null`11399 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

11400 

11401 The error from the tool call, if any.

11402 

11403 - `string`

11356 11404 

11357 The error from the tool call, if any.11405 The error from the tool call, if any.

11358 11406 

11407 - `McpProtocolError object { code, message, type }`

11408 

11409 - `code: number`

11410 

11411 - `message: string`

11412 

11413 - `type: "mcp_protocol_error"`

11414 

11415 - `"mcp_protocol_error"`

11416 

11417 - `McpToolExecutionError object { content, type }`

11418 

11419 - `content: unknown`

11420 

11421 - `type: "mcp_tool_execution_error"`

11422 

11423 - `"mcp_tool_execution_error"`

11424 

11425 - `HTTPError object { code, message, type }`

11426 

11427 - `code: number`

11428 

11429 - `message: string`

11430 

11431 - `type: "http_error"`

11432 

11433 - `"http_error"`

11434 

11359 - `output: optional string or null`11435 - `output: optional string or null`

11360 11436 

11361 The output from the tool call.11437 The output from the tool call.


12641 for reasoning items returned by `POST /v1/responses` and WebSocket12717 for reasoning items returned by `POST /v1/responses` and WebSocket

12642 `response.create` requests.12718 `response.create` requests.

12643 12719 

12720 When streaming, use the completed reasoning item and its

12721 `encrypted_content` from the `response.output_item.done` event in

12722 subsequent requests. The `encrypted_content` in

12723 `response.output_item.added` may be incomplete. This is especially

12724 important when `store` is `false` or when using Zero Data Retention.

12725 

12644 - `status: optional "in_progress" or "completed" or "incomplete"`12726 - `status: optional "in_progress" or "completed" or "incomplete"`

12645 12727 

12646 The status of the item. One of `in_progress`, `completed`, or12728 The status of the item. One of `in_progress`, `completed`, or


15518 Unique identifier for the MCP tool call approval request.15600 Unique identifier for the MCP tool call approval request.

15519 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.15601 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

15520 15602 

15521 - `error: optional string or null`15603 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

15604 

15605 The error from the tool call, if any.

15606 

15607 - `string`

15522 15608 

15523 The error from the tool call, if any.15609 The error from the tool call, if any.

15524 15610 

15611 - `McpProtocolError object { code, message, type }`

15612 

15613 - `code: number`

15614 

15615 - `message: string`

15616 

15617 - `type: "mcp_protocol_error"`

15618 

15619 - `"mcp_protocol_error"`

15620 

15621 - `McpToolExecutionError object { content, type }`

15622 

15623 - `content: unknown`

15624 

15625 - `type: "mcp_tool_execution_error"`

15626 

15627 - `"mcp_tool_execution_error"`

15628 

15629 - `HTTPError object { code, message, type }`

15630 

15631 - `code: number`

15632 

15633 - `message: string`

15634 

15635 - `type: "http_error"`

15636 

15637 - `"http_error"`

15638 

15525 - `output: optional string or null`15639 - `output: optional string or null`

15526 15640 

15527 The output from the tool call.15641 The output from the tool call.

Details

3906 for reasoning items returned by `POST /v1/responses` and WebSocket3906 for reasoning items returned by `POST /v1/responses` and WebSocket

3907 `response.create` requests.3907 `response.create` requests.

3908 3908 

3909 When streaming, use the completed reasoning item and its

3910 `encrypted_content` from the `response.output_item.done` event in

3911 subsequent requests. The `encrypted_content` in

3912 `response.output_item.added` may be incomplete. This is especially

3913 important when `store` is `false` or when using Zero Data Retention.

3914 

3909 - `status: optional "in_progress" or "completed" or "incomplete"`3915 - `status: optional "in_progress" or "completed" or "incomplete"`

3910 3916 

3911 The status of the item. One of `in_progress`, `completed`, or3917 The status of the item. One of `in_progress`, `completed`, or


4679 Unique identifier for the MCP tool call approval request.4685 Unique identifier for the MCP tool call approval request.

4680 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.4686 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

4681 4687 

4682 - `error: optional string or null`4688 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

4689 

4690 The error from the tool call, if any.

4691 

4692 - `string`

4683 4693 

4684 The error from the tool call, if any.4694 The error from the tool call, if any.

4685 4695 

4696 - `McpProtocolError object { code, message, type }`

4697 

4698 - `code: number`

4699 

4700 - `message: string`

4701 

4702 - `type: "mcp_protocol_error"`

4703 

4704 - `"mcp_protocol_error"`

4705 

4706 - `McpToolExecutionError object { content, type }`

4707 

4708 - `content: unknown`

4709 

4710 - `type: "mcp_tool_execution_error"`

4711 

4712 - `"mcp_tool_execution_error"`

4713 

4714 - `HTTPError object { code, message, type }`

4715 

4716 - `code: number`

4717 

4718 - `message: string`

4719 

4720 - `type: "http_error"`

4721 

4722 - `"http_error"`

4723 

4686 - `output: optional string or null`4724 - `output: optional string or null`

4687 4725 

4688 The output from the tool call.4726 The output from the tool call.


5968 for reasoning items returned by `POST /v1/responses` and WebSocket6006 for reasoning items returned by `POST /v1/responses` and WebSocket

5969 `response.create` requests.6007 `response.create` requests.

5970 6008 

6009 When streaming, use the completed reasoning item and its

6010 `encrypted_content` from the `response.output_item.done` event in

6011 subsequent requests. The `encrypted_content` in

6012 `response.output_item.added` may be incomplete. This is especially

6013 important when `store` is `false` or when using Zero Data Retention.

6014 

5971 - `status: optional "in_progress" or "completed" or "incomplete"`6015 - `status: optional "in_progress" or "completed" or "incomplete"`

5972 6016 

5973 The status of the item. One of `in_progress`, `completed`, or6017 The status of the item. One of `in_progress`, `completed`, or


8845 Unique identifier for the MCP tool call approval request.8889 Unique identifier for the MCP tool call approval request.

8846 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.8890 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

8847 8891 

8848 - `error: optional string or null`8892 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

8893 

8894 The error from the tool call, if any.

8895 

8896 - `string`

8849 8897 

8850 The error from the tool call, if any.8898 The error from the tool call, if any.

8851 8899 

8900 - `McpProtocolError object { code, message, type }`

8901 

8902 - `code: number`

8903 

8904 - `message: string`

8905 

8906 - `type: "mcp_protocol_error"`

8907 

8908 - `"mcp_protocol_error"`

8909 

8910 - `McpToolExecutionError object { content, type }`

8911 

8912 - `content: unknown`

8913 

8914 - `type: "mcp_tool_execution_error"`

8915 

8916 - `"mcp_tool_execution_error"`

8917 

8918 - `HTTPError object { code, message, type }`

8919 

8920 - `code: number`

8921 

8922 - `message: string`

8923 

8924 - `type: "http_error"`

8925 

8926 - `"http_error"`

8927 

8852 - `output: optional string or null`8928 - `output: optional string or null`

8853 8929 

8854 The output from the tool call.8930 The output from the tool call.

Details

3721 for reasoning items returned by `POST /v1/responses` and WebSocket3721 for reasoning items returned by `POST /v1/responses` and WebSocket

3722 `response.create` requests.3722 `response.create` requests.

3723 3723 

3724 When streaming, use the completed reasoning item and its

3725 `encrypted_content` from the `response.output_item.done` event in

3726 subsequent requests. The `encrypted_content` in

3727 `response.output_item.added` may be incomplete. This is especially

3728 important when `store` is `false` or when using Zero Data Retention.

3729 

3724 - `status: optional "in_progress" or "completed" or "incomplete"`3730 - `status: optional "in_progress" or "completed" or "incomplete"`

3725 3731 

3726 The status of the item. One of `in_progress`, `completed`, or3732 The status of the item. One of `in_progress`, `completed`, or


4586 Unique identifier for the MCP tool call approval request.4592 Unique identifier for the MCP tool call approval request.

4587 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.4593 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

4588 4594 

4589 - `error: optional string or null`4595 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

4596 

4597 The error from the tool call, if any.

4598 

4599 - `string`

4590 4600 

4591 The error from the tool call, if any.4601 The error from the tool call, if any.

4592 4602 

4603 - `McpProtocolError object { code, message, type }`

4604 

4605 - `code: number`

4606 

4607 - `message: string`

4608 

4609 - `type: "mcp_protocol_error"`

4610 

4611 - `"mcp_protocol_error"`

4612 

4613 - `McpToolExecutionError object { content, type }`

4614 

4615 - `content: unknown`

4616 

4617 - `type: "mcp_tool_execution_error"`

4618 

4619 - `"mcp_tool_execution_error"`

4620 

4621 - `HTTPError object { code, message, type }`

4622 

4623 - `code: number`

4624 

4625 - `message: string`

4626 

4627 - `type: "http_error"`

4628 

4629 - `"http_error"`

4630 

4593 - `output: optional string or null`4631 - `output: optional string or null`

4594 4632 

4595 The output from the tool call.4633 The output from the tool call.


8519 for reasoning items returned by `POST /v1/responses` and WebSocket8557 for reasoning items returned by `POST /v1/responses` and WebSocket

8520 `response.create` requests.8558 `response.create` requests.

8521 8559 

8560 When streaming, use the completed reasoning item and its

8561 `encrypted_content` from the `response.output_item.done` event in

8562 subsequent requests. The `encrypted_content` in

8563 `response.output_item.added` may be incomplete. This is especially

8564 important when `store` is `false` or when using Zero Data Retention.

8565 

8522 - `status: optional "in_progress" or "completed" or "incomplete"`8566 - `status: optional "in_progress" or "completed" or "incomplete"`

8523 8567 

8524 The status of the item. One of `in_progress`, `completed`, or8568 The status of the item. One of `in_progress`, `completed`, or


9384 Unique identifier for the MCP tool call approval request.9428 Unique identifier for the MCP tool call approval request.

9385 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.9429 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

9386 9430 

9387 - `error: optional string or null`9431 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

9432 

9433 The error from the tool call, if any.

9434 

9435 - `string`

9388 9436 

9389 The error from the tool call, if any.9437 The error from the tool call, if any.

9390 9438 

9439 - `McpProtocolError object { code, message, type }`

9440 

9441 - `code: number`

9442 

9443 - `message: string`

9444 

9445 - `type: "mcp_protocol_error"`

9446 

9447 - `"mcp_protocol_error"`

9448 

9449 - `McpToolExecutionError object { content, type }`

9450 

9451 - `content: unknown`

9452 

9453 - `type: "mcp_tool_execution_error"`

9454 

9455 - `"mcp_tool_execution_error"`

9456 

9457 - `HTTPError object { code, message, type }`

9458 

9459 - `code: number`

9460 

9461 - `message: string`

9462 

9463 - `type: "http_error"`

9464 

9465 - `"http_error"`

9466 

9391 - `output: optional string or null`9467 - `output: optional string or null`

9392 9468 

9393 The output from the tool call.9469 The output from the tool call.

Details

3719 for reasoning items returned by `POST /v1/responses` and WebSocket3719 for reasoning items returned by `POST /v1/responses` and WebSocket

3720 `response.create` requests.3720 `response.create` requests.

3721 3721 

3722 When streaming, use the completed reasoning item and its

3723 `encrypted_content` from the `response.output_item.done` event in

3724 subsequent requests. The `encrypted_content` in

3725 `response.output_item.added` may be incomplete. This is especially

3726 important when `store` is `false` or when using Zero Data Retention.

3727 

3722 - `status: optional "in_progress" or "completed" or "incomplete"`3728 - `status: optional "in_progress" or "completed" or "incomplete"`

3723 3729 

3724 The status of the item. One of `in_progress`, `completed`, or3730 The status of the item. One of `in_progress`, `completed`, or


4584 Unique identifier for the MCP tool call approval request.4590 Unique identifier for the MCP tool call approval request.

4585 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.4591 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

4586 4592 

4587 - `error: optional string or null`4593 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

4594 

4595 The error from the tool call, if any.

4596 

4597 - `string`

4588 4598 

4589 The error from the tool call, if any.4599 The error from the tool call, if any.

4590 4600 

4601 - `McpProtocolError object { code, message, type }`

4602 

4603 - `code: number`

4604 

4605 - `message: string`

4606 

4607 - `type: "mcp_protocol_error"`

4608 

4609 - `"mcp_protocol_error"`

4610 

4611 - `McpToolExecutionError object { content, type }`

4612 

4613 - `content: unknown`

4614 

4615 - `type: "mcp_tool_execution_error"`

4616 

4617 - `"mcp_tool_execution_error"`

4618 

4619 - `HTTPError object { code, message, type }`

4620 

4621 - `code: number`

4622 

4623 - `message: string`

4624 

4625 - `type: "http_error"`

4626 

4627 - `"http_error"`

4628 

4591 - `output: optional string or null`4629 - `output: optional string or null`

4592 4630 

4593 The output from the tool call.4631 The output from the tool call.

Details

3797 for reasoning items returned by `POST /v1/responses` and WebSocket3797 for reasoning items returned by `POST /v1/responses` and WebSocket

3798 `response.create` requests.3798 `response.create` requests.

3799 3799 

3800 When streaming, use the completed reasoning item and its

3801 `encrypted_content` from the `response.output_item.done` event in

3802 subsequent requests. The `encrypted_content` in

3803 `response.output_item.added` may be incomplete. This is especially

3804 important when `store` is `false` or when using Zero Data Retention.

3805 

3800 - `status: optional "in_progress" or "completed" or "incomplete"`3806 - `status: optional "in_progress" or "completed" or "incomplete"`

3801 3807 

3802 The status of the item. One of `in_progress`, `completed`, or3808 The status of the item. One of `in_progress`, `completed`, or


4570 Unique identifier for the MCP tool call approval request.4576 Unique identifier for the MCP tool call approval request.

4571 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.4577 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

4572 4578 

4573 - `error: optional string or null`4579 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

4580 

4581 The error from the tool call, if any.

4582 

4583 - `string`

4574 4584 

4575 The error from the tool call, if any.4585 The error from the tool call, if any.

4576 4586 

4587 - `McpProtocolError object { code, message, type }`

4588 

4589 - `code: number`

4590 

4591 - `message: string`

4592 

4593 - `type: "mcp_protocol_error"`

4594 

4595 - `"mcp_protocol_error"`

4596 

4597 - `McpToolExecutionError object { content, type }`

4598 

4599 - `content: unknown`

4600 

4601 - `type: "mcp_tool_execution_error"`

4602 

4603 - `"mcp_tool_execution_error"`

4604 

4605 - `HTTPError object { code, message, type }`

4606 

4607 - `code: number`

4608 

4609 - `message: string`

4610 

4611 - `type: "http_error"`

4612 

4613 - `"http_error"`

4614 

4577 - `output: optional string or null`4615 - `output: optional string or null`

4578 4616 

4579 The output from the tool call.4617 The output from the tool call.

Details

3795 for reasoning items returned by `POST /v1/responses` and WebSocket3795 for reasoning items returned by `POST /v1/responses` and WebSocket

3796 `response.create` requests.3796 `response.create` requests.

3797 3797 

3798 When streaming, use the completed reasoning item and its

3799 `encrypted_content` from the `response.output_item.done` event in

3800 subsequent requests. The `encrypted_content` in

3801 `response.output_item.added` may be incomplete. This is especially

3802 important when `store` is `false` or when using Zero Data Retention.

3803 

3798 - `status: optional "in_progress" or "completed" or "incomplete"`3804 - `status: optional "in_progress" or "completed" or "incomplete"`

3799 3805 

3800 The status of the item. One of `in_progress`, `completed`, or3806 The status of the item. One of `in_progress`, `completed`, or


4568 Unique identifier for the MCP tool call approval request.4574 Unique identifier for the MCP tool call approval request.

4569 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.4575 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

4570 4576 

4571 - `error: optional string or null`4577 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

4578 

4579 The error from the tool call, if any.

4580 

4581 - `string`

4572 4582 

4573 The error from the tool call, if any.4583 The error from the tool call, if any.

4574 4584 

4585 - `McpProtocolError object { code, message, type }`

4586 

4587 - `code: number`

4588 

4589 - `message: string`

4590 

4591 - `type: "mcp_protocol_error"`

4592 

4593 - `"mcp_protocol_error"`

4594 

4595 - `McpToolExecutionError object { content, type }`

4596 

4597 - `content: unknown`

4598 

4599 - `type: "mcp_tool_execution_error"`

4600 

4601 - `"mcp_tool_execution_error"`

4602 

4603 - `HTTPError object { code, message, type }`

4604 

4605 - `code: number`

4606 

4607 - `message: string`

4608 

4609 - `type: "http_error"`

4610 

4611 - `"http_error"`

4612 

4575 - `output: optional string or null`4613 - `output: optional string or null`

4576 4614 

4577 The output from the tool call.4615 The output from the tool call.

Details

1834 1834 

1835 Total number of tokens used in the request (prompt + completion).1835 Total number of tokens used in the request (prompt + completion).

1836 1836 

1837 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, rejected_prediction_tokens }`1837 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, 2 more }`

1838 1838 

1839 Breakdown of tokens used in a completion.1839 Breakdown of tokens used in a completion.

1840 1840 


1859 completion tokens for purposes of billing, output, and context window1859 completion tokens for purposes of billing, output, and context window

1860 limits.1860 limits.

1861 1861 

1862 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens }`1862 - `text_tokens: optional number`

1863 

1864 Text output tokens generated by the model.

1865 

1866 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens, 2 more }`

1863 1867 

1864 Breakdown of tokens used in the prompt.1868 Breakdown of tokens used in the prompt.

1865 1869 


1875 1879 

1876 Cached tokens present in the prompt.1880 Cached tokens present in the prompt.

1877 1881 

1882 - `image_tokens: optional number`

1883 

1884 Image input tokens present in the prompt.

1885 

1886 - `text_tokens: optional number`

1887 

1888 Text input tokens present in the prompt.

1889 

1878### Example1890### Example

1879 1891 

1880```http1892```http


2042 "accepted_prediction_tokens": 0,2054 "accepted_prediction_tokens": 0,

2043 "audio_tokens": 0,2055 "audio_tokens": 0,

2044 "reasoning_tokens": 0,2056 "reasoning_tokens": 0,

2045 "rejected_prediction_tokens": 02057 "rejected_prediction_tokens": 0,

2058 "text_tokens": 0

2046 },2059 },

2047 "prompt_tokens_details": {2060 "prompt_tokens_details": {

2048 "audio_tokens": 0,2061 "audio_tokens": 0,

2049 "cache_write_tokens": 0,2062 "cache_write_tokens": 0,

2050 "cached_tokens": 02063 "cached_tokens": 0,

2064 "image_tokens": 0,

2065 "text_tokens": 0

2051 }2066 }

2052 }2067 }

2053}2068}


3051 3066 

3052 Total number of tokens used in the request (prompt + completion).3067 Total number of tokens used in the request (prompt + completion).

3053 3068 

3054 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, rejected_prediction_tokens }`3069 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, 2 more }`

3055 3070 

3056 Breakdown of tokens used in a completion.3071 Breakdown of tokens used in a completion.

3057 3072 


3076 completion tokens for purposes of billing, output, and context window3091 completion tokens for purposes of billing, output, and context window

3077 limits.3092 limits.

3078 3093 

3079 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens }`3094 - `text_tokens: optional number`

3095 

3096 Text output tokens generated by the model.

3097 

3098 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens, 2 more }`

3080 3099 

3081 Breakdown of tokens used in the prompt.3100 Breakdown of tokens used in the prompt.

3082 3101 


3092 3111 

3093 Cached tokens present in the prompt.3112 Cached tokens present in the prompt.

3094 3113 

3114 - `image_tokens: optional number`

3115 

3116 Image input tokens present in the prompt.

3117 

3118 - `text_tokens: optional number`

3119 

3120 Text input tokens present in the prompt.

3121 

3095- `first_id: string`3122- `first_id: string`

3096 3123 

3097 The identifier of the first chat completion in the data array.3124 The identifier of the first chat completion in the data array.


3263 "accepted_prediction_tokens": 0,3290 "accepted_prediction_tokens": 0,

3264 "audio_tokens": 0,3291 "audio_tokens": 0,

3265 "reasoning_tokens": 0,3292 "reasoning_tokens": 0,

3266 "rejected_prediction_tokens": 03293 "rejected_prediction_tokens": 0,

3294 "text_tokens": 0

3267 },3295 },

3268 "prompt_tokens_details": {3296 "prompt_tokens_details": {

3269 "audio_tokens": 0,3297 "audio_tokens": 0,

3270 "cache_write_tokens": 0,3298 "cache_write_tokens": 0,

3271 "cached_tokens": 03299 "cached_tokens": 0,

3300 "image_tokens": 0,

3301 "text_tokens": 0

3272 }3302 }

3273 }3303 }

3274 }3304 }


3787 3817 

3788 Total number of tokens used in the request (prompt + completion).3818 Total number of tokens used in the request (prompt + completion).

3789 3819 

3790 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, rejected_prediction_tokens }`3820 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, 2 more }`

3791 3821 

3792 Breakdown of tokens used in a completion.3822 Breakdown of tokens used in a completion.

3793 3823 


3812 completion tokens for purposes of billing, output, and context window3842 completion tokens for purposes of billing, output, and context window

3813 limits.3843 limits.

3814 3844 

3815 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens }`3845 - `text_tokens: optional number`

3846 

3847 Text output tokens generated by the model.

3848 

3849 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens, 2 more }`

3816 3850 

3817 Breakdown of tokens used in the prompt.3851 Breakdown of tokens used in the prompt.

3818 3852 


3828 3862 

3829 Cached tokens present in the prompt.3863 Cached tokens present in the prompt.

3830 3864 

3865 - `image_tokens: optional number`

3866 

3867 Image input tokens present in the prompt.

3868 

3869 - `text_tokens: optional number`

3870 

3871 Text input tokens present in the prompt.

3872 

3831### Example3873### Example

3832 3874 

3833```http3875```http


3979 "accepted_prediction_tokens": 0,4021 "accepted_prediction_tokens": 0,

3980 "audio_tokens": 0,4022 "audio_tokens": 0,

3981 "reasoning_tokens": 0,4023 "reasoning_tokens": 0,

3982 "rejected_prediction_tokens": 04024 "rejected_prediction_tokens": 0,

4025 "text_tokens": 0

3983 },4026 },

3984 "prompt_tokens_details": {4027 "prompt_tokens_details": {

3985 "audio_tokens": 0,4028 "audio_tokens": 0,

3986 "cache_write_tokens": 0,4029 "cache_write_tokens": 0,

3987 "cached_tokens": 04030 "cached_tokens": 0,

4031 "image_tokens": 0,

4032 "text_tokens": 0

3988 }4033 }

3989 }4034 }

3990}4035}


4501 4546 

4502 Total number of tokens used in the request (prompt + completion).4547 Total number of tokens used in the request (prompt + completion).

4503 4548 

4504 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, rejected_prediction_tokens }`4549 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, 2 more }`

4505 4550 

4506 Breakdown of tokens used in a completion.4551 Breakdown of tokens used in a completion.

4507 4552 


4526 completion tokens for purposes of billing, output, and context window4571 completion tokens for purposes of billing, output, and context window

4527 limits.4572 limits.

4528 4573 

4529 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens }`4574 - `text_tokens: optional number`

4575 

4576 Text output tokens generated by the model.

4577 

4578 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens, 2 more }`

4530 4579 

4531 Breakdown of tokens used in the prompt.4580 Breakdown of tokens used in the prompt.

4532 4581 


4542 4591 

4543 Cached tokens present in the prompt.4592 Cached tokens present in the prompt.

4544 4593 

4594 - `image_tokens: optional number`

4595 

4596 Image input tokens present in the prompt.

4597 

4598 - `text_tokens: optional number`

4599 

4600 Text input tokens present in the prompt.

4601 

4545### Example4602### Example

4546 4603 

4547```http4604```http


4699 "accepted_prediction_tokens": 0,4756 "accepted_prediction_tokens": 0,

4700 "audio_tokens": 0,4757 "audio_tokens": 0,

4701 "reasoning_tokens": 0,4758 "reasoning_tokens": 0,

4702 "rejected_prediction_tokens": 04759 "rejected_prediction_tokens": 0,

4760 "text_tokens": 0

4703 },4761 },

4704 "prompt_tokens_details": {4762 "prompt_tokens_details": {

4705 "audio_tokens": 0,4763 "audio_tokens": 0,

4706 "cache_write_tokens": 0,4764 "cache_write_tokens": 0,

4707 "cached_tokens": 04765 "cached_tokens": 0,

4766 "image_tokens": 0,

4767 "text_tokens": 0

4708 }4768 }

4709 }4769 }

4710}4770}


5235 5295 

5236 Total number of tokens used in the request (prompt + completion).5296 Total number of tokens used in the request (prompt + completion).

5237 5297 

5238 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, rejected_prediction_tokens }`5298 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, 2 more }`

5239 5299 

5240 Breakdown of tokens used in a completion.5300 Breakdown of tokens used in a completion.

5241 5301 


5260 completion tokens for purposes of billing, output, and context window5320 completion tokens for purposes of billing, output, and context window

5261 limits.5321 limits.

5262 5322 

5263 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens }`5323 - `text_tokens: optional number`

5324 

5325 Text output tokens generated by the model.

5326 

5327 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens, 2 more }`

5264 5328 

5265 Breakdown of tokens used in the prompt.5329 Breakdown of tokens used in the prompt.

5266 5330 


5276 5340 

5277 Cached tokens present in the prompt.5341 Cached tokens present in the prompt.

5278 5342 

5343 - `image_tokens: optional number`

5344 

5345 Image input tokens present in the prompt.

5346 

5347 - `text_tokens: optional number`

5348 

5349 Text input tokens present in the prompt.

5350 

5279### Chat Completion Allowed Tool Choice5351### Chat Completion Allowed Tool Choice

5280 5352 

5281- `ChatCompletionAllowedToolChoice object { allowed_tools, type }`5353- `ChatCompletionAllowedToolChoice object { allowed_tools, type }`


5919 5991 

5920 Total number of tokens used in the request (prompt + completion).5992 Total number of tokens used in the request (prompt + completion).

5921 5993 

5922 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, rejected_prediction_tokens }`5994 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, 2 more }`

5923 5995 

5924 Breakdown of tokens used in a completion.5996 Breakdown of tokens used in a completion.

5925 5997 


5944 completion tokens for purposes of billing, output, and context window6016 completion tokens for purposes of billing, output, and context window

5945 limits.6017 limits.

5946 6018 

5947 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens }`6019 - `text_tokens: optional number`

6020 

6021 Text output tokens generated by the model.

6022 

6023 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens, 2 more }`

5948 6024 

5949 Breakdown of tokens used in the prompt.6025 Breakdown of tokens used in the prompt.

5950 6026 


5960 6036 

5961 Cached tokens present in the prompt.6037 Cached tokens present in the prompt.

5962 6038 

6039 - `image_tokens: optional number`

6040 

6041 Image input tokens present in the prompt.

6042 

6043 - `text_tokens: optional number`

6044 

6045 Text input tokens present in the prompt.

6046 

5963### Chat Completion Content Part6047### Chat Completion Content Part

5964 6048 

5965- `ChatCompletionContentPart = ChatCompletionContentPartText or ChatCompletionContentPartImage or ChatCompletionContentPartInputAudio or object { file, type, prompt_cache_breakpoint }`6049- `ChatCompletionContentPart = ChatCompletionContentPartText or ChatCompletionContentPartImage or ChatCompletionContentPartInputAudio or object { file, type, prompt_cache_breakpoint }`

Details

1832 1832 

1833 Total number of tokens used in the request (prompt + completion).1833 Total number of tokens used in the request (prompt + completion).

1834 1834 

1835 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, rejected_prediction_tokens }`1835 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, 2 more }`

1836 1836 

1837 Breakdown of tokens used in a completion.1837 Breakdown of tokens used in a completion.

1838 1838 


1857 completion tokens for purposes of billing, output, and context window1857 completion tokens for purposes of billing, output, and context window

1858 limits.1858 limits.

1859 1859 

1860 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens }`1860 - `text_tokens: optional number`

1861 

1862 Text output tokens generated by the model.

1863 

1864 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens, 2 more }`

1861 1865 

1862 Breakdown of tokens used in the prompt.1866 Breakdown of tokens used in the prompt.

1863 1867 


1873 1877 

1874 Cached tokens present in the prompt.1878 Cached tokens present in the prompt.

1875 1879 

1880 - `image_tokens: optional number`

1881 

1882 Image input tokens present in the prompt.

1883 

1884 - `text_tokens: optional number`

1885 

1886 Text input tokens present in the prompt.

1887 

1876### Example1888### Example

1877 1889 

1878```http1890```http


2040 "accepted_prediction_tokens": 0,2052 "accepted_prediction_tokens": 0,

2041 "audio_tokens": 0,2053 "audio_tokens": 0,

2042 "reasoning_tokens": 0,2054 "reasoning_tokens": 0,

2043 "rejected_prediction_tokens": 02055 "rejected_prediction_tokens": 0,

2056 "text_tokens": 0

2044 },2057 },

2045 "prompt_tokens_details": {2058 "prompt_tokens_details": {

2046 "audio_tokens": 0,2059 "audio_tokens": 0,

2047 "cache_write_tokens": 0,2060 "cache_write_tokens": 0,

2048 "cached_tokens": 02061 "cached_tokens": 0,

2062 "image_tokens": 0,

2063 "text_tokens": 0

2049 }2064 }

2050 }2065 }

2051}2066}


3049 3064 

3050 Total number of tokens used in the request (prompt + completion).3065 Total number of tokens used in the request (prompt + completion).

3051 3066 

3052 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, rejected_prediction_tokens }`3067 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, 2 more }`

3053 3068 

3054 Breakdown of tokens used in a completion.3069 Breakdown of tokens used in a completion.

3055 3070 


3074 completion tokens for purposes of billing, output, and context window3089 completion tokens for purposes of billing, output, and context window

3075 limits.3090 limits.

3076 3091 

3077 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens }`3092 - `text_tokens: optional number`

3093 

3094 Text output tokens generated by the model.

3095 

3096 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens, 2 more }`

3078 3097 

3079 Breakdown of tokens used in the prompt.3098 Breakdown of tokens used in the prompt.

3080 3099 


3090 3109 

3091 Cached tokens present in the prompt.3110 Cached tokens present in the prompt.

3092 3111 

3112 - `image_tokens: optional number`

3113 

3114 Image input tokens present in the prompt.

3115 

3116 - `text_tokens: optional number`

3117 

3118 Text input tokens present in the prompt.

3119 

3093- `first_id: string`3120- `first_id: string`

3094 3121 

3095 The identifier of the first chat completion in the data array.3122 The identifier of the first chat completion in the data array.


3261 "accepted_prediction_tokens": 0,3288 "accepted_prediction_tokens": 0,

3262 "audio_tokens": 0,3289 "audio_tokens": 0,

3263 "reasoning_tokens": 0,3290 "reasoning_tokens": 0,

3264 "rejected_prediction_tokens": 03291 "rejected_prediction_tokens": 0,

3292 "text_tokens": 0

3265 },3293 },

3266 "prompt_tokens_details": {3294 "prompt_tokens_details": {

3267 "audio_tokens": 0,3295 "audio_tokens": 0,

3268 "cache_write_tokens": 0,3296 "cache_write_tokens": 0,

3269 "cached_tokens": 03297 "cached_tokens": 0,

3298 "image_tokens": 0,

3299 "text_tokens": 0

3270 }3300 }

3271 }3301 }

3272 }3302 }


3785 3815 

3786 Total number of tokens used in the request (prompt + completion).3816 Total number of tokens used in the request (prompt + completion).

3787 3817 

3788 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, rejected_prediction_tokens }`3818 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, 2 more }`

3789 3819 

3790 Breakdown of tokens used in a completion.3820 Breakdown of tokens used in a completion.

3791 3821 


3810 completion tokens for purposes of billing, output, and context window3840 completion tokens for purposes of billing, output, and context window

3811 limits.3841 limits.

3812 3842 

3813 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens }`3843 - `text_tokens: optional number`

3844 

3845 Text output tokens generated by the model.

3846 

3847 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens, 2 more }`

3814 3848 

3815 Breakdown of tokens used in the prompt.3849 Breakdown of tokens used in the prompt.

3816 3850 


3826 3860 

3827 Cached tokens present in the prompt.3861 Cached tokens present in the prompt.

3828 3862 

3863 - `image_tokens: optional number`

3864 

3865 Image input tokens present in the prompt.

3866 

3867 - `text_tokens: optional number`

3868 

3869 Text input tokens present in the prompt.

3870 

3829### Example3871### Example

3830 3872 

3831```http3873```http


3977 "accepted_prediction_tokens": 0,4019 "accepted_prediction_tokens": 0,

3978 "audio_tokens": 0,4020 "audio_tokens": 0,

3979 "reasoning_tokens": 0,4021 "reasoning_tokens": 0,

3980 "rejected_prediction_tokens": 04022 "rejected_prediction_tokens": 0,

4023 "text_tokens": 0

3981 },4024 },

3982 "prompt_tokens_details": {4025 "prompt_tokens_details": {

3983 "audio_tokens": 0,4026 "audio_tokens": 0,

3984 "cache_write_tokens": 0,4027 "cache_write_tokens": 0,

3985 "cached_tokens": 04028 "cached_tokens": 0,

4029 "image_tokens": 0,

4030 "text_tokens": 0

3986 }4031 }

3987 }4032 }

3988}4033}


4499 4544 

4500 Total number of tokens used in the request (prompt + completion).4545 Total number of tokens used in the request (prompt + completion).

4501 4546 

4502 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, rejected_prediction_tokens }`4547 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, 2 more }`

4503 4548 

4504 Breakdown of tokens used in a completion.4549 Breakdown of tokens used in a completion.

4505 4550 


4524 completion tokens for purposes of billing, output, and context window4569 completion tokens for purposes of billing, output, and context window

4525 limits.4570 limits.

4526 4571 

4527 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens }`4572 - `text_tokens: optional number`

4573 

4574 Text output tokens generated by the model.

4575 

4576 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens, 2 more }`

4528 4577 

4529 Breakdown of tokens used in the prompt.4578 Breakdown of tokens used in the prompt.

4530 4579 


4540 4589 

4541 Cached tokens present in the prompt.4590 Cached tokens present in the prompt.

4542 4591 

4592 - `image_tokens: optional number`

4593 

4594 Image input tokens present in the prompt.

4595 

4596 - `text_tokens: optional number`

4597 

4598 Text input tokens present in the prompt.

4599 

4543### Example4600### Example

4544 4601 

4545```http4602```http


4697 "accepted_prediction_tokens": 0,4754 "accepted_prediction_tokens": 0,

4698 "audio_tokens": 0,4755 "audio_tokens": 0,

4699 "reasoning_tokens": 0,4756 "reasoning_tokens": 0,

4700 "rejected_prediction_tokens": 04757 "rejected_prediction_tokens": 0,

4758 "text_tokens": 0

4701 },4759 },

4702 "prompt_tokens_details": {4760 "prompt_tokens_details": {

4703 "audio_tokens": 0,4761 "audio_tokens": 0,

4704 "cache_write_tokens": 0,4762 "cache_write_tokens": 0,

4705 "cached_tokens": 04763 "cached_tokens": 0,

4764 "image_tokens": 0,

4765 "text_tokens": 0

4706 }4766 }

4707 }4767 }

4708}4768}


5233 5293 

5234 Total number of tokens used in the request (prompt + completion).5294 Total number of tokens used in the request (prompt + completion).

5235 5295 

5236 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, rejected_prediction_tokens }`5296 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, 2 more }`

5237 5297 

5238 Breakdown of tokens used in a completion.5298 Breakdown of tokens used in a completion.

5239 5299 


5258 completion tokens for purposes of billing, output, and context window5318 completion tokens for purposes of billing, output, and context window

5259 limits.5319 limits.

5260 5320 

5261 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens }`5321 - `text_tokens: optional number`

5322 

5323 Text output tokens generated by the model.

5324 

5325 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens, 2 more }`

5262 5326 

5263 Breakdown of tokens used in the prompt.5327 Breakdown of tokens used in the prompt.

5264 5328 


5274 5338 

5275 Cached tokens present in the prompt.5339 Cached tokens present in the prompt.

5276 5340 

5341 - `image_tokens: optional number`

5342 

5343 Image input tokens present in the prompt.

5344 

5345 - `text_tokens: optional number`

5346 

5347 Text input tokens present in the prompt.

5348 

5277### Chat Completion Allowed Tool Choice5349### Chat Completion Allowed Tool Choice

5278 5350 

5279- `ChatCompletionAllowedToolChoice object { allowed_tools, type }`5351- `ChatCompletionAllowedToolChoice object { allowed_tools, type }`


5917 5989 

5918 Total number of tokens used in the request (prompt + completion).5990 Total number of tokens used in the request (prompt + completion).

5919 5991 

5920 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, rejected_prediction_tokens }`5992 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, 2 more }`

5921 5993 

5922 Breakdown of tokens used in a completion.5994 Breakdown of tokens used in a completion.

5923 5995 


5942 completion tokens for purposes of billing, output, and context window6014 completion tokens for purposes of billing, output, and context window

5943 limits.6015 limits.

5944 6016 

5945 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens }`6017 - `text_tokens: optional number`

6018 

6019 Text output tokens generated by the model.

6020 

6021 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens, 2 more }`

5946 6022 

5947 Breakdown of tokens used in the prompt.6023 Breakdown of tokens used in the prompt.

5948 6024 


5958 6034 

5959 Cached tokens present in the prompt.6035 Cached tokens present in the prompt.

5960 6036 

6037 - `image_tokens: optional number`

6038 

6039 Image input tokens present in the prompt.

6040 

6041 - `text_tokens: optional number`

6042 

6043 Text input tokens present in the prompt.

6044 

5961### Chat Completion Content Part6045### Chat Completion Content Part

5962 6046 

5963- `ChatCompletionContentPart = ChatCompletionContentPartText or ChatCompletionContentPartImage or ChatCompletionContentPartInputAudio or object { file, type, prompt_cache_breakpoint }`6047- `ChatCompletionContentPart = ChatCompletionContentPartText or ChatCompletionContentPartImage or ChatCompletionContentPartInputAudio or object { file, type, prompt_cache_breakpoint }`

Details

1830 1830 

1831 Total number of tokens used in the request (prompt + completion).1831 Total number of tokens used in the request (prompt + completion).

1832 1832 

1833 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, rejected_prediction_tokens }`1833 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, 2 more }`

1834 1834 

1835 Breakdown of tokens used in a completion.1835 Breakdown of tokens used in a completion.

1836 1836 


1855 completion tokens for purposes of billing, output, and context window1855 completion tokens for purposes of billing, output, and context window

1856 limits.1856 limits.

1857 1857 

1858 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens }`1858 - `text_tokens: optional number`

1859 

1860 Text output tokens generated by the model.

1861 

1862 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens, 2 more }`

1859 1863 

1860 Breakdown of tokens used in the prompt.1864 Breakdown of tokens used in the prompt.

1861 1865 


1871 1875 

1872 Cached tokens present in the prompt.1876 Cached tokens present in the prompt.

1873 1877 

1878 - `image_tokens: optional number`

1879 

1880 Image input tokens present in the prompt.

1881 

1882 - `text_tokens: optional number`

1883 

1884 Text input tokens present in the prompt.

1885 

1874### Example1886### Example

1875 1887 

1876```http1888```http


2038 "accepted_prediction_tokens": 0,2050 "accepted_prediction_tokens": 0,

2039 "audio_tokens": 0,2051 "audio_tokens": 0,

2040 "reasoning_tokens": 0,2052 "reasoning_tokens": 0,

2041 "rejected_prediction_tokens": 02053 "rejected_prediction_tokens": 0,

2054 "text_tokens": 0

2042 },2055 },

2043 "prompt_tokens_details": {2056 "prompt_tokens_details": {

2044 "audio_tokens": 0,2057 "audio_tokens": 0,

2045 "cache_write_tokens": 0,2058 "cache_write_tokens": 0,

2046 "cached_tokens": 02059 "cached_tokens": 0,

2060 "image_tokens": 0,

2061 "text_tokens": 0

2047 }2062 }

2048 }2063 }

2049}2064}

Details

471 471 

472 Total number of tokens used in the request (prompt + completion).472 Total number of tokens used in the request (prompt + completion).

473 473 

474 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, rejected_prediction_tokens }`474 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, 2 more }`

475 475 

476 Breakdown of tokens used in a completion.476 Breakdown of tokens used in a completion.

477 477 


496 completion tokens for purposes of billing, output, and context window496 completion tokens for purposes of billing, output, and context window

497 limits.497 limits.

498 498 

499 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens }`499 - `text_tokens: optional number`

500 

501 Text output tokens generated by the model.

502 

503 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens, 2 more }`

500 504 

501 Breakdown of tokens used in the prompt.505 Breakdown of tokens used in the prompt.

502 506 


512 516 

513 Cached tokens present in the prompt.517 Cached tokens present in the prompt.

514 518 

519 - `image_tokens: optional number`

520 

521 Image input tokens present in the prompt.

522 

523 - `text_tokens: optional number`

524 

525 Text input tokens present in the prompt.

526 

515- `first_id: string`527- `first_id: string`

516 528 

517 The identifier of the first chat completion in the data array.529 The identifier of the first chat completion in the data array.


683 "accepted_prediction_tokens": 0,695 "accepted_prediction_tokens": 0,

684 "audio_tokens": 0,696 "audio_tokens": 0,

685 "reasoning_tokens": 0,697 "reasoning_tokens": 0,

686 "rejected_prediction_tokens": 0698 "rejected_prediction_tokens": 0,

699 "text_tokens": 0

687 },700 },

688 "prompt_tokens_details": {701 "prompt_tokens_details": {

689 "audio_tokens": 0,702 "audio_tokens": 0,

690 "cache_write_tokens": 0,703 "cache_write_tokens": 0,

691 "cached_tokens": 0704 "cached_tokens": 0,

705 "image_tokens": 0,

706 "text_tokens": 0

692 }707 }

693 }708 }

694 }709 }

Details

447 447 

448 Total number of tokens used in the request (prompt + completion).448 Total number of tokens used in the request (prompt + completion).

449 449 

450 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, rejected_prediction_tokens }`450 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, 2 more }`

451 451 

452 Breakdown of tokens used in a completion.452 Breakdown of tokens used in a completion.

453 453 


472 completion tokens for purposes of billing, output, and context window472 completion tokens for purposes of billing, output, and context window

473 limits.473 limits.

474 474 

475 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens }`475 - `text_tokens: optional number`

476 

477 Text output tokens generated by the model.

478 

479 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens, 2 more }`

476 480 

477 Breakdown of tokens used in the prompt.481 Breakdown of tokens used in the prompt.

478 482 


488 492 

489 Cached tokens present in the prompt.493 Cached tokens present in the prompt.

490 494 

495 - `image_tokens: optional number`

496 

497 Image input tokens present in the prompt.

498 

499 - `text_tokens: optional number`

500 

501 Text input tokens present in the prompt.

502 

491### Example503### Example

492 504 

493```http505```http


639 "accepted_prediction_tokens": 0,651 "accepted_prediction_tokens": 0,

640 "audio_tokens": 0,652 "audio_tokens": 0,

641 "reasoning_tokens": 0,653 "reasoning_tokens": 0,

642 "rejected_prediction_tokens": 0654 "rejected_prediction_tokens": 0,

655 "text_tokens": 0

643 },656 },

644 "prompt_tokens_details": {657 "prompt_tokens_details": {

645 "audio_tokens": 0,658 "audio_tokens": 0,

646 "cache_write_tokens": 0,659 "cache_write_tokens": 0,

647 "cached_tokens": 0660 "cached_tokens": 0,

661 "image_tokens": 0,

662 "text_tokens": 0

648 }663 }

649 }664 }

650}665}

Details

459 459 

460 Total number of tokens used in the request (prompt + completion).460 Total number of tokens used in the request (prompt + completion).

461 461 

462 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, rejected_prediction_tokens }`462 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, 2 more }`

463 463 

464 Breakdown of tokens used in a completion.464 Breakdown of tokens used in a completion.

465 465 


484 completion tokens for purposes of billing, output, and context window484 completion tokens for purposes of billing, output, and context window

485 limits.485 limits.

486 486 

487 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens }`487 - `text_tokens: optional number`

488 

489 Text output tokens generated by the model.

490 

491 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens, 2 more }`

488 492 

489 Breakdown of tokens used in the prompt.493 Breakdown of tokens used in the prompt.

490 494 


500 504 

501 Cached tokens present in the prompt.505 Cached tokens present in the prompt.

502 506 

507 - `image_tokens: optional number`

508 

509 Image input tokens present in the prompt.

510 

511 - `text_tokens: optional number`

512 

513 Text input tokens present in the prompt.

514 

503### Example515### Example

504 516 

505```http517```http


657 "accepted_prediction_tokens": 0,669 "accepted_prediction_tokens": 0,

658 "audio_tokens": 0,670 "audio_tokens": 0,

659 "reasoning_tokens": 0,671 "reasoning_tokens": 0,

660 "rejected_prediction_tokens": 0672 "rejected_prediction_tokens": 0,

673 "text_tokens": 0

661 },674 },

662 "prompt_tokens_details": {675 "prompt_tokens_details": {

663 "audio_tokens": 0,676 "audio_tokens": 0,

664 "cache_write_tokens": 0,677 "cache_write_tokens": 0,

665 "cached_tokens": 0678 "cached_tokens": 0,

679 "image_tokens": 0,

680 "text_tokens": 0

666 }681 }

667 }682 }

668}683}

Details

624 },624 },

625 {625 {

626 "ident": "rejected_prediction_tokens"626 "ident": "rejected_prediction_tokens"

627 },

628 {

629 "ident": "text_tokens"

627 }630 }

628 ]631 ]

629 },632 },


635 "(resource) completions > (model) completion_usage > (schema) > (property) completion_tokens_details > (property) accepted_prediction_tokens",638 "(resource) completions > (model) completion_usage > (schema) > (property) completion_tokens_details > (property) accepted_prediction_tokens",

636 "(resource) completions > (model) completion_usage > (schema) > (property) completion_tokens_details > (property) audio_tokens",639 "(resource) completions > (model) completion_usage > (schema) > (property) completion_tokens_details > (property) audio_tokens",

637 "(resource) completions > (model) completion_usage > (schema) > (property) completion_tokens_details > (property) reasoning_tokens",640 "(resource) completions > (model) completion_usage > (schema) > (property) completion_tokens_details > (property) reasoning_tokens",

638 "(resource) completions > (model) completion_usage > (schema) > (property) completion_tokens_details > (property) rejected_prediction_tokens"641 "(resource) completions > (model) completion_usage > (schema) > (property) completion_tokens_details > (property) rejected_prediction_tokens",

642 "(resource) completions > (model) completion_usage > (schema) > (property) completion_tokens_details > (property) text_tokens"

639 ]643 ]

640 },644 },

641 "(resource) completions > (model) completion_usage > (schema) > (property) prompt_tokens_details": {645 "(resource) completions > (model) completion_usage > (schema) > (property) prompt_tokens_details": {


655 },659 },

656 {660 {

657 "ident": "cached_tokens"661 "ident": "cached_tokens"

662 },

663 {

664 "ident": "image_tokens"

665 },

666 {

667 "ident": "text_tokens"

658 }668 }

659 ]669 ]

660 },670 },


665 "children": [675 "children": [

666 "(resource) completions > (model) completion_usage > (schema) > (property) prompt_tokens_details > (property) audio_tokens",676 "(resource) completions > (model) completion_usage > (schema) > (property) prompt_tokens_details > (property) audio_tokens",

667 "(resource) completions > (model) completion_usage > (schema) > (property) prompt_tokens_details > (property) cache_write_tokens",677 "(resource) completions > (model) completion_usage > (schema) > (property) prompt_tokens_details > (property) cache_write_tokens",

668 "(resource) completions > (model) completion_usage > (schema) > (property) prompt_tokens_details > (property) cached_tokens"678 "(resource) completions > (model) completion_usage > (schema) > (property) prompt_tokens_details > (property) cached_tokens",

679 "(resource) completions > (model) completion_usage > (schema) > (property) prompt_tokens_details > (property) image_tokens",

680 "(resource) completions > (model) completion_usage > (schema) > (property) prompt_tokens_details > (property) text_tokens"

669 ]681 ]

670 },682 },

671 "(resource) completions > (model) completion_usage > (schema)": {683 "(resource) completions > (model) completion_usage > (schema)": {


1088 "schemaType": "integer",1100 "schemaType": "integer",

1089 "children": []1101 "children": []

1090 },1102 },

1103 "(resource) completions > (model) completion_usage > (schema) > (property) completion_tokens_details > (property) text_tokens": {

1104 "kind": "HttpDeclProperty",

1105 "oasRef": "#/components/schemas/CompletionUsage/properties/completion_tokens_details/properties/text_tokens",

1106 "deprecated": false,

1107 "key": "text_tokens",

1108 "docstring": "Text output tokens generated by the model.",

1109 "type": {

1110 "kind": "HttpTypeNumber"

1111 },

1112 "optional": true,

1113 "nullable": false,

1114 "schemaType": "integer",

1115 "children": []

1116 },

1091 "(resource) completions > (model) completion_usage > (schema) > (property) prompt_tokens_details > (property) audio_tokens": {1117 "(resource) completions > (model) completion_usage > (schema) > (property) prompt_tokens_details > (property) audio_tokens": {

1092 "kind": "HttpDeclProperty",1118 "kind": "HttpDeclProperty",

1093 "oasRef": "#/components/schemas/CompletionUsage/properties/prompt_tokens_details/properties/audio_tokens",1119 "oasRef": "#/components/schemas/CompletionUsage/properties/prompt_tokens_details/properties/audio_tokens",


1133 "schemaType": "integer",1159 "schemaType": "integer",

1134 "children": []1160 "children": []

1135 },1161 },

1162 "(resource) completions > (model) completion_usage > (schema) > (property) prompt_tokens_details > (property) image_tokens": {

1163 "kind": "HttpDeclProperty",

1164 "oasRef": "#/components/schemas/CompletionUsage/properties/prompt_tokens_details/properties/image_tokens",

1165 "deprecated": false,

1166 "key": "image_tokens",

1167 "docstring": "Image input tokens present in the prompt.",

1168 "type": {

1169 "kind": "HttpTypeNumber"

1170 },

1171 "optional": true,

1172 "nullable": false,

1173 "schemaType": "integer",

1174 "children": []

1175 },

1176 "(resource) completions > (model) completion_usage > (schema) > (property) prompt_tokens_details > (property) text_tokens": {

1177 "kind": "HttpDeclProperty",

1178 "oasRef": "#/components/schemas/CompletionUsage/properties/prompt_tokens_details/properties/text_tokens",

1179 "deprecated": false,

1180 "key": "text_tokens",

1181 "docstring": "Text input tokens present in the prompt.",

1182 "type": {

1183 "kind": "HttpTypeNumber"

1184 },

1185 "optional": true,

1186 "nullable": false,

1187 "schemaType": "integer",

1188 "children": []

1189 },

1136 "(resource) chat.completions > (model) chat_completion_chunk > (schema) > (property) choices > (items) > (property) delta > (property) function_call > (property) arguments": {1190 "(resource) chat.completions > (model) chat_completion_chunk > (schema) > (property) choices > (items) > (property) delta > (property) function_call > (property) arguments": {

1137 "kind": "HttpDeclProperty",1191 "kind": "HttpDeclProperty",

1138 "oasRef": "#/components/schemas/ChatCompletionStreamResponseDelta/properties/function_call/properties/arguments",1192 "oasRef": "#/components/schemas/ChatCompletionStreamResponseDelta/properties/function_call/properties/arguments",

Details

234 234 

235 Total number of tokens used in the request (prompt + completion).235 Total number of tokens used in the request (prompt + completion).

236 236 

237 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, rejected_prediction_tokens }`237 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, 2 more }`

238 238 

239 Breakdown of tokens used in a completion.239 Breakdown of tokens used in a completion.

240 240 


259 completion tokens for purposes of billing, output, and context window259 completion tokens for purposes of billing, output, and context window

260 limits.260 limits.

261 261 

262 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens }`262 - `text_tokens: optional number`

263 

264 Text output tokens generated by the model.

265 

266 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens, 2 more }`

263 267 

264 Breakdown of tokens used in the prompt.268 Breakdown of tokens used in the prompt.

265 269 


275 279 

276 Cached tokens present in the prompt.280 Cached tokens present in the prompt.

277 281 

282 - `image_tokens: optional number`

283 

284 Image input tokens present in the prompt.

285 

286 - `text_tokens: optional number`

287 

288 Text input tokens present in the prompt.

289 

278### Example290### Example

279 291 

280```http292```http


333 "accepted_prediction_tokens": 0,345 "accepted_prediction_tokens": 0,

334 "audio_tokens": 0,346 "audio_tokens": 0,

335 "reasoning_tokens": 0,347 "reasoning_tokens": 0,

336 "rejected_prediction_tokens": 0348 "rejected_prediction_tokens": 0,

349 "text_tokens": 0

337 },350 },

338 "prompt_tokens_details": {351 "prompt_tokens_details": {

339 "audio_tokens": 0,352 "audio_tokens": 0,

340 "cache_write_tokens": 0,353 "cache_write_tokens": 0,

341 "cached_tokens": 0354 "cached_tokens": 0,

355 "image_tokens": 0,

356 "text_tokens": 0

342 }357 }

343 }358 }

344}359}


496 511 

497 Total number of tokens used in the request (prompt + completion).512 Total number of tokens used in the request (prompt + completion).

498 513 

499 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, rejected_prediction_tokens }`514 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, 2 more }`

500 515 

501 Breakdown of tokens used in a completion.516 Breakdown of tokens used in a completion.

502 517 


521 completion tokens for purposes of billing, output, and context window536 completion tokens for purposes of billing, output, and context window

522 limits.537 limits.

523 538 

524 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens }`539 - `text_tokens: optional number`

540 

541 Text output tokens generated by the model.

542 

543 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens, 2 more }`

525 544 

526 Breakdown of tokens used in the prompt.545 Breakdown of tokens used in the prompt.

527 546 


537 556 

538 Cached tokens present in the prompt.557 Cached tokens present in the prompt.

539 558 

559 - `image_tokens: optional number`

560 

561 Image input tokens present in the prompt.

562 

563 - `text_tokens: optional number`

564 

565 Text input tokens present in the prompt.

566 

540### Completion Choice567### Completion Choice

541 568 

542- `CompletionChoice object { finish_reason, index, logprobs, text }`569- `CompletionChoice object { finish_reason, index, logprobs, text }`


585 612 

586 Total number of tokens used in the request (prompt + completion).613 Total number of tokens used in the request (prompt + completion).

587 614 

588 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, rejected_prediction_tokens }`615 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, 2 more }`

589 616 

590 Breakdown of tokens used in a completion.617 Breakdown of tokens used in a completion.

591 618 


610 completion tokens for purposes of billing, output, and context window637 completion tokens for purposes of billing, output, and context window

611 limits.638 limits.

612 639 

613 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens }`640 - `text_tokens: optional number`

641 

642 Text output tokens generated by the model.

643 

644 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens, 2 more }`

614 645 

615 Breakdown of tokens used in the prompt.646 Breakdown of tokens used in the prompt.

616 647 


625 - `cached_tokens: optional number`656 - `cached_tokens: optional number`

626 657 

627 Cached tokens present in the prompt.658 Cached tokens present in the prompt.

659 

660 - `image_tokens: optional number`

661 

662 Image input tokens present in the prompt.

663 

664 - `text_tokens: optional number`

665 

666 Text input tokens present in the prompt.

Details

232 232 

233 Total number of tokens used in the request (prompt + completion).233 Total number of tokens used in the request (prompt + completion).

234 234 

235 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, rejected_prediction_tokens }`235 - `completion_tokens_details: optional object { accepted_prediction_tokens, audio_tokens, reasoning_tokens, 2 more }`

236 236 

237 Breakdown of tokens used in a completion.237 Breakdown of tokens used in a completion.

238 238 


257 completion tokens for purposes of billing, output, and context window257 completion tokens for purposes of billing, output, and context window

258 limits.258 limits.

259 259 

260 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens }`260 - `text_tokens: optional number`

261 

262 Text output tokens generated by the model.

263 

264 - `prompt_tokens_details: optional object { audio_tokens, cache_write_tokens, cached_tokens, 2 more }`

261 265 

262 Breakdown of tokens used in the prompt.266 Breakdown of tokens used in the prompt.

263 267 


273 277 

274 Cached tokens present in the prompt.278 Cached tokens present in the prompt.

275 279 

280 - `image_tokens: optional number`

281 

282 Image input tokens present in the prompt.

283 

284 - `text_tokens: optional number`

285 

286 Text input tokens present in the prompt.

287 

276### Example288### Example

277 289 

278```http290```http


331 "accepted_prediction_tokens": 0,343 "accepted_prediction_tokens": 0,

332 "audio_tokens": 0,344 "audio_tokens": 0,

333 "reasoning_tokens": 0,345 "reasoning_tokens": 0,

334 "rejected_prediction_tokens": 0346 "rejected_prediction_tokens": 0,

347 "text_tokens": 0

335 },348 },

336 "prompt_tokens_details": {349 "prompt_tokens_details": {

337 "audio_tokens": 0,350 "audio_tokens": 0,

338 "cache_write_tokens": 0,351 "cache_write_tokens": 0,

339 "cached_tokens": 0352 "cached_tokens": 0,

353 "image_tokens": 0,

354 "text_tokens": 0

340 }355 }

341 }356 }

342}357}

Details

3177 for reasoning items returned by `POST /v1/responses` and WebSocket3177 for reasoning items returned by `POST /v1/responses` and WebSocket

3178 `response.create` requests.3178 `response.create` requests.

3179 3179 

3180 When streaming, use the completed reasoning item and its

3181 `encrypted_content` from the `response.output_item.done` event in

3182 subsequent requests. The `encrypted_content` in

3183 `response.output_item.added` may be incomplete. This is especially

3184 important when `store` is `false` or when using Zero Data Retention.

3185 

3180 - `status: optional "in_progress" or "completed" or "incomplete"`3186 - `status: optional "in_progress" or "completed" or "incomplete"`

3181 3187 

3182 The status of the item. One of `in_progress`, `completed`, or3188 The status of the item. One of `in_progress`, `completed`, or


3846 Unique identifier for the MCP tool call approval request.3852 Unique identifier for the MCP tool call approval request.

3847 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.3853 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

3848 3854 

3849 - `error: optional string or null`3855 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

3850 3856 

3851 The error from the tool call, if any.3857 The error from the tool call, if any.

3852 3858 

3859 - `string`

3860 

3861 The error from the tool call, if any.

3862 

3863 - `McpProtocolError object { code, message, type }`

3864 

3865 - `code: number`

3866 

3867 - `message: string`

3868 

3869 - `type: "mcp_protocol_error"`

3870 

3871 - `"mcp_protocol_error"`

3872 

3873 - `McpToolExecutionError object { content, type }`

3874 

3875 - `content: unknown`

3876 

3877 - `type: "mcp_tool_execution_error"`

3878 

3879 - `"mcp_tool_execution_error"`

3880 

3881 - `HTTPError object { code, message, type }`

3882 

3883 - `code: number`

3884 

3885 - `message: string`

3886 

3887 - `type: "http_error"`

3888 

3889 - `"http_error"`

3890 

3853 - `output: optional string or null`3891 - `output: optional string or null`

3854 3892 

3855 The output from the tool call.3893 The output from the tool call.


8072 for reasoning items returned by `POST /v1/responses` and WebSocket8110 for reasoning items returned by `POST /v1/responses` and WebSocket

8073 `response.create` requests.8111 `response.create` requests.

8074 8112 

8113 When streaming, use the completed reasoning item and its

8114 `encrypted_content` from the `response.output_item.done` event in

8115 subsequent requests. The `encrypted_content` in

8116 `response.output_item.added` may be incomplete. This is especially

8117 important when `store` is `false` or when using Zero Data Retention.

8118 

8075 - `status: optional "in_progress" or "completed" or "incomplete"`8119 - `status: optional "in_progress" or "completed" or "incomplete"`

8076 8120 

8077 The status of the item. One of `in_progress`, `completed`, or8121 The status of the item. One of `in_progress`, `completed`, or


8741 Unique identifier for the MCP tool call approval request.8785 Unique identifier for the MCP tool call approval request.

8742 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.8786 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

8743 8787 

8744 - `error: optional string or null`8788 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

8745 8789 

8746 The error from the tool call, if any.8790 The error from the tool call, if any.

8747 8791 

8792 - `string`

8793 

8794 The error from the tool call, if any.

8795 

8796 - `McpProtocolError object { code, message, type }`

8797 

8798 - `code: number`

8799 

8800 - `message: string`

8801 

8802 - `type: "mcp_protocol_error"`

8803 

8804 - `"mcp_protocol_error"`

8805 

8806 - `McpToolExecutionError object { content, type }`

8807 

8808 - `content: unknown`

8809 

8810 - `type: "mcp_tool_execution_error"`

8811 

8812 - `"mcp_tool_execution_error"`

8813 

8814 - `HTTPError object { code, message, type }`

8815 

8816 - `code: number`

8817 

8818 - `message: string`

8819 

8820 - `type: "http_error"`

8821 

8822 - `"http_error"`

8823 

8748 - `output: optional string or null`8824 - `output: optional string or null`

8749 8825 

8750 The output from the tool call.8826 The output from the tool call.


12094 for reasoning items returned by `POST /v1/responses` and WebSocket12170 for reasoning items returned by `POST /v1/responses` and WebSocket

12095 `response.create` requests.12171 `response.create` requests.

12096 12172 

12173 When streaming, use the completed reasoning item and its

12174 `encrypted_content` from the `response.output_item.done` event in

12175 subsequent requests. The `encrypted_content` in

12176 `response.output_item.added` may be incomplete. This is especially

12177 important when `store` is `false` or when using Zero Data Retention.

12178 

12097 - `status: optional "in_progress" or "completed" or "incomplete"`12179 - `status: optional "in_progress" or "completed" or "incomplete"`

12098 12180 

12099 The status of the item. One of `in_progress`, `completed`, or12181 The status of the item. One of `in_progress`, `completed`, or


12809 Unique identifier for the MCP tool call approval request.12891 Unique identifier for the MCP tool call approval request.

12810 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.12892 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

12811 12893 

12812 - `error: optional string or null`12894 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

12895 

12896 The error from the tool call, if any.

12897 

12898 - `string`

12813 12899 

12814 The error from the tool call, if any.12900 The error from the tool call, if any.

12815 12901 

12902 - `McpProtocolError object { code, message, type }`

12903 

12904 - `code: number`

12905 

12906 - `message: string`

12907 

12908 - `type: "mcp_protocol_error"`

12909 

12910 - `"mcp_protocol_error"`

12911 

12912 - `McpToolExecutionError object { content, type }`

12913 

12914 - `content: unknown`

12915 

12916 - `type: "mcp_tool_execution_error"`

12917 

12918 - `"mcp_tool_execution_error"`

12919 

12920 - `HTTPError object { code, message, type }`

12921 

12922 - `code: number`

12923 

12924 - `message: string`

12925 

12926 - `type: "http_error"`

12927 

12928 - `"http_error"`

12929 

12816 - `output: optional string or null`12930 - `output: optional string or null`

12817 12931 

12818 The output from the tool call.12932 The output from the tool call.


16339 for reasoning items returned by `POST /v1/responses` and WebSocket16453 for reasoning items returned by `POST /v1/responses` and WebSocket

16340 `response.create` requests.16454 `response.create` requests.

16341 16455 

16456 When streaming, use the completed reasoning item and its

16457 `encrypted_content` from the `response.output_item.done` event in

16458 subsequent requests. The `encrypted_content` in

16459 `response.output_item.added` may be incomplete. This is especially

16460 important when `store` is `false` or when using Zero Data Retention.

16461 

16342 - `status: optional "in_progress" or "completed" or "incomplete"`16462 - `status: optional "in_progress" or "completed" or "incomplete"`

16343 16463 

16344 The status of the item. One of `in_progress`, `completed`, or16464 The status of the item. One of `in_progress`, `completed`, or


17054 Unique identifier for the MCP tool call approval request.17174 Unique identifier for the MCP tool call approval request.

17055 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.17175 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

17056 17176 

17057 - `error: optional string or null`17177 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

17058 17178 

17059 The error from the tool call, if any.17179 The error from the tool call, if any.

17060 17180 

17181 - `string`

17182 

17183 The error from the tool call, if any.

17184 

17185 - `McpProtocolError object { code, message, type }`

17186 

17187 - `code: number`

17188 

17189 - `message: string`

17190 

17191 - `type: "mcp_protocol_error"`

17192 

17193 - `"mcp_protocol_error"`

17194 

17195 - `McpToolExecutionError object { content, type }`

17196 

17197 - `content: unknown`

17198 

17199 - `type: "mcp_tool_execution_error"`

17200 

17201 - `"mcp_tool_execution_error"`

17202 

17203 - `HTTPError object { code, message, type }`

17204 

17205 - `code: number`

17206 

17207 - `message: string`

17208 

17209 - `type: "http_error"`

17210 

17211 - `"http_error"`

17212 

17061 - `output: optional string or null`17213 - `output: optional string or null`

17062 17214 

17063 The output from the tool call.17215 The output from the tool call.


20445 for reasoning items returned by `POST /v1/responses` and WebSocket20597 for reasoning items returned by `POST /v1/responses` and WebSocket

20446 `response.create` requests.20598 `response.create` requests.

20447 20599 

20600 When streaming, use the completed reasoning item and its

20601 `encrypted_content` from the `response.output_item.done` event in

20602 subsequent requests. The `encrypted_content` in

20603 `response.output_item.added` may be incomplete. This is especially

20604 important when `store` is `false` or when using Zero Data Retention.

20605 

20448 - `status: optional "in_progress" or "completed" or "incomplete"`20606 - `status: optional "in_progress" or "completed" or "incomplete"`

20449 20607 

20450 The status of the item. One of `in_progress`, `completed`, or20608 The status of the item. One of `in_progress`, `completed`, or


21160 Unique identifier for the MCP tool call approval request.21318 Unique identifier for the MCP tool call approval request.

21161 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.21319 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

21162 21320 

21163 - `error: optional string or null`21321 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

21164 21322 

21165 The error from the tool call, if any.21323 The error from the tool call, if any.

21166 21324 

21325 - `string`

21326 

21327 The error from the tool call, if any.

21328 

21329 - `McpProtocolError object { code, message, type }`

21330 

21331 - `code: number`

21332 

21333 - `message: string`

21334 

21335 - `type: "mcp_protocol_error"`

21336 

21337 - `"mcp_protocol_error"`

21338 

21339 - `McpToolExecutionError object { content, type }`

21340 

21341 - `content: unknown`

21342 

21343 - `type: "mcp_tool_execution_error"`

21344 

21345 - `"mcp_tool_execution_error"`

21346 

21347 - `HTTPError object { code, message, type }`

21348 

21349 - `code: number`

21350 

21351 - `message: string`

21352 

21353 - `type: "http_error"`

21354 

21355 - `"http_error"`

21356 

21167 - `output: optional string or null`21357 - `output: optional string or null`

21168 21358 

21169 The output from the tool call.21359 The output from the tool call.


24484 for reasoning items returned by `POST /v1/responses` and WebSocket24674 for reasoning items returned by `POST /v1/responses` and WebSocket

24485 `response.create` requests.24675 `response.create` requests.

24486 24676 

24677 When streaming, use the completed reasoning item and its

24678 `encrypted_content` from the `response.output_item.done` event in

24679 subsequent requests. The `encrypted_content` in

24680 `response.output_item.added` may be incomplete. This is especially

24681 important when `store` is `false` or when using Zero Data Retention.

24682 

24487 - `status: optional "in_progress" or "completed" or "incomplete"`24683 - `status: optional "in_progress" or "completed" or "incomplete"`

24488 24684 

24489 The status of the item. One of `in_progress`, `completed`, or24685 The status of the item. One of `in_progress`, `completed`, or


25199 Unique identifier for the MCP tool call approval request.25395 Unique identifier for the MCP tool call approval request.

25200 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.25396 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

25201 25397 

25202 - `error: optional string or null`25398 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

25399 

25400 The error from the tool call, if any.

25401 

25402 - `string`

25203 25403 

25204 The error from the tool call, if any.25404 The error from the tool call, if any.

25205 25405 

25406 - `McpProtocolError object { code, message, type }`

25407 

25408 - `code: number`

25409 

25410 - `message: string`

25411 

25412 - `type: "mcp_protocol_error"`

25413 

25414 - `"mcp_protocol_error"`

25415 

25416 - `McpToolExecutionError object { content, type }`

25417 

25418 - `content: unknown`

25419 

25420 - `type: "mcp_tool_execution_error"`

25421 

25422 - `"mcp_tool_execution_error"`

25423 

25424 - `HTTPError object { code, message, type }`

25425 

25426 - `code: number`

25427 

25428 - `message: string`

25429 

25430 - `type: "http_error"`

25431 

25432 - `"http_error"`

25433 

25206 - `output: optional string or null`25434 - `output: optional string or null`

25207 25435 

25208 The output from the tool call.25436 The output from the tool call.


28476 for reasoning items returned by `POST /v1/responses` and WebSocket28704 for reasoning items returned by `POST /v1/responses` and WebSocket

28477 `response.create` requests.28705 `response.create` requests.

28478 28706 

28707 When streaming, use the completed reasoning item and its

28708 `encrypted_content` from the `response.output_item.done` event in

28709 subsequent requests. The `encrypted_content` in

28710 `response.output_item.added` may be incomplete. This is especially

28711 important when `store` is `false` or when using Zero Data Retention.

28712 

28479 - `status: optional "in_progress" or "completed" or "incomplete"`28713 - `status: optional "in_progress" or "completed" or "incomplete"`

28480 28714 

28481 The status of the item. One of `in_progress`, `completed`, or28715 The status of the item. One of `in_progress`, `completed`, or


29191 Unique identifier for the MCP tool call approval request.29425 Unique identifier for the MCP tool call approval request.

29192 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.29426 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

29193 29427 

29194 - `error: optional string or null`29428 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

29195 29429 

29196 The error from the tool call, if any.29430 The error from the tool call, if any.

29197 29431 

29432 - `string`

29433 

29434 The error from the tool call, if any.

29435 

29436 - `McpProtocolError object { code, message, type }`

29437 

29438 - `code: number`

29439 

29440 - `message: string`

29441 

29442 - `type: "mcp_protocol_error"`

29443 

29444 - `"mcp_protocol_error"`

29445 

29446 - `McpToolExecutionError object { content, type }`

29447 

29448 - `content: unknown`

29449 

29450 - `type: "mcp_tool_execution_error"`

29451 

29452 - `"mcp_tool_execution_error"`

29453 

29454 - `HTTPError object { code, message, type }`

29455 

29456 - `code: number`

29457 

29458 - `message: string`

29459 

29460 - `type: "http_error"`

29461 

29462 - `"http_error"`

29463 

29198 - `output: optional string or null`29464 - `output: optional string or null`

29199 29465 

29200 The output from the tool call.29466 The output from the tool call.

Details

3175 for reasoning items returned by `POST /v1/responses` and WebSocket3175 for reasoning items returned by `POST /v1/responses` and WebSocket

3176 `response.create` requests.3176 `response.create` requests.

3177 3177 

3178 When streaming, use the completed reasoning item and its

3179 `encrypted_content` from the `response.output_item.done` event in

3180 subsequent requests. The `encrypted_content` in

3181 `response.output_item.added` may be incomplete. This is especially

3182 important when `store` is `false` or when using Zero Data Retention.

3183 

3178 - `status: optional "in_progress" or "completed" or "incomplete"`3184 - `status: optional "in_progress" or "completed" or "incomplete"`

3179 3185 

3180 The status of the item. One of `in_progress`, `completed`, or3186 The status of the item. One of `in_progress`, `completed`, or


3844 Unique identifier for the MCP tool call approval request.3850 Unique identifier for the MCP tool call approval request.

3845 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.3851 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

3846 3852 

3847 - `error: optional string or null`3853 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

3854 

3855 The error from the tool call, if any.

3856 

3857 - `string`

3848 3858 

3849 The error from the tool call, if any.3859 The error from the tool call, if any.

3850 3860 

3861 - `McpProtocolError object { code, message, type }`

3862 

3863 - `code: number`

3864 

3865 - `message: string`

3866 

3867 - `type: "mcp_protocol_error"`

3868 

3869 - `"mcp_protocol_error"`

3870 

3871 - `McpToolExecutionError object { content, type }`

3872 

3873 - `content: unknown`

3874 

3875 - `type: "mcp_tool_execution_error"`

3876 

3877 - `"mcp_tool_execution_error"`

3878 

3879 - `HTTPError object { code, message, type }`

3880 

3881 - `code: number`

3882 

3883 - `message: string`

3884 

3885 - `type: "http_error"`

3886 

3887 - `"http_error"`

3888 

3851 - `output: optional string or null`3889 - `output: optional string or null`

3852 3890 

3853 The output from the tool call.3891 The output from the tool call.

Details

3204 for reasoning items returned by `POST /v1/responses` and WebSocket3204 for reasoning items returned by `POST /v1/responses` and WebSocket

3205 `response.create` requests.3205 `response.create` requests.

3206 3206 

3207 When streaming, use the completed reasoning item and its

3208 `encrypted_content` from the `response.output_item.done` event in

3209 subsequent requests. The `encrypted_content` in

3210 `response.output_item.added` may be incomplete. This is especially

3211 important when `store` is `false` or when using Zero Data Retention.

3212 

3207 - `status: optional "in_progress" or "completed" or "incomplete"`3213 - `status: optional "in_progress" or "completed" or "incomplete"`

3208 3214 

3209 The status of the item. One of `in_progress`, `completed`, or3215 The status of the item. One of `in_progress`, `completed`, or


3873 Unique identifier for the MCP tool call approval request.3879 Unique identifier for the MCP tool call approval request.

3874 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.3880 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

3875 3881 

3876 - `error: optional string or null`3882 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

3883 

3884 The error from the tool call, if any.

3885 

3886 - `string`

3877 3887 

3878 The error from the tool call, if any.3888 The error from the tool call, if any.

3879 3889 

3890 - `McpProtocolError object { code, message, type }`

3891 

3892 - `code: number`

3893 

3894 - `message: string`

3895 

3896 - `type: "mcp_protocol_error"`

3897 

3898 - `"mcp_protocol_error"`

3899 

3900 - `McpToolExecutionError object { content, type }`

3901 

3902 - `content: unknown`

3903 

3904 - `type: "mcp_tool_execution_error"`

3905 

3906 - `"mcp_tool_execution_error"`

3907 

3908 - `HTTPError object { code, message, type }`

3909 

3910 - `code: number`

3911 

3912 - `message: string`

3913 

3914 - `type: "http_error"`

3915 

3916 - `"http_error"`

3917 

3880 - `output: optional string or null`3918 - `output: optional string or null`

3881 3919 

3882 The output from the tool call.3920 The output from the tool call.


7226 for reasoning items returned by `POST /v1/responses` and WebSocket7264 for reasoning items returned by `POST /v1/responses` and WebSocket

7227 `response.create` requests.7265 `response.create` requests.

7228 7266 

7267 When streaming, use the completed reasoning item and its

7268 `encrypted_content` from the `response.output_item.done` event in

7269 subsequent requests. The `encrypted_content` in

7270 `response.output_item.added` may be incomplete. This is especially

7271 important when `store` is `false` or when using Zero Data Retention.

7272 

7229 - `status: optional "in_progress" or "completed" or "incomplete"`7273 - `status: optional "in_progress" or "completed" or "incomplete"`

7230 7274 

7231 The status of the item. One of `in_progress`, `completed`, or7275 The status of the item. One of `in_progress`, `completed`, or


7941 Unique identifier for the MCP tool call approval request.7985 Unique identifier for the MCP tool call approval request.

7942 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.7986 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

7943 7987 

7944 - `error: optional string or null`7988 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

7945 7989 

7946 The error from the tool call, if any.7990 The error from the tool call, if any.

7947 7991 

7992 - `string`

7993 

7994 The error from the tool call, if any.

7995 

7996 - `McpProtocolError object { code, message, type }`

7997 

7998 - `code: number`

7999 

8000 - `message: string`

8001 

8002 - `type: "mcp_protocol_error"`

8003 

8004 - `"mcp_protocol_error"`

8005 

8006 - `McpToolExecutionError object { content, type }`

8007 

8008 - `content: unknown`

8009 

8010 - `type: "mcp_tool_execution_error"`

8011 

8012 - `"mcp_tool_execution_error"`

8013 

8014 - `HTTPError object { code, message, type }`

8015 

8016 - `code: number`

8017 

8018 - `message: string`

8019 

8020 - `type: "http_error"`

8021 

8022 - `"http_error"`

8023 

7948 - `output: optional string or null`8024 - `output: optional string or null`

7949 8025 

7950 The output from the tool call.8026 The output from the tool call.


11471 for reasoning items returned by `POST /v1/responses` and WebSocket11547 for reasoning items returned by `POST /v1/responses` and WebSocket

11472 `response.create` requests.11548 `response.create` requests.

11473 11549 

11550 When streaming, use the completed reasoning item and its

11551 `encrypted_content` from the `response.output_item.done` event in

11552 subsequent requests. The `encrypted_content` in

11553 `response.output_item.added` may be incomplete. This is especially

11554 important when `store` is `false` or when using Zero Data Retention.

11555 

11474 - `status: optional "in_progress" or "completed" or "incomplete"`11556 - `status: optional "in_progress" or "completed" or "incomplete"`

11475 11557 

11476 The status of the item. One of `in_progress`, `completed`, or11558 The status of the item. One of `in_progress`, `completed`, or


12186 Unique identifier for the MCP tool call approval request.12268 Unique identifier for the MCP tool call approval request.

12187 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.12269 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

12188 12270 

12189 - `error: optional string or null`12271 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

12272 

12273 The error from the tool call, if any.

12274 

12275 - `string`

12190 12276 

12191 The error from the tool call, if any.12277 The error from the tool call, if any.

12192 12278 

12279 - `McpProtocolError object { code, message, type }`

12280 

12281 - `code: number`

12282 

12283 - `message: string`

12284 

12285 - `type: "mcp_protocol_error"`

12286 

12287 - `"mcp_protocol_error"`

12288 

12289 - `McpToolExecutionError object { content, type }`

12290 

12291 - `content: unknown`

12292 

12293 - `type: "mcp_tool_execution_error"`

12294 

12295 - `"mcp_tool_execution_error"`

12296 

12297 - `HTTPError object { code, message, type }`

12298 

12299 - `code: number`

12300 

12301 - `message: string`

12302 

12303 - `type: "http_error"`

12304 

12305 - `"http_error"`

12306 

12193 - `output: optional string or null`12307 - `output: optional string or null`

12194 12308 

12195 The output from the tool call.12309 The output from the tool call.


15577 for reasoning items returned by `POST /v1/responses` and WebSocket15691 for reasoning items returned by `POST /v1/responses` and WebSocket

15578 `response.create` requests.15692 `response.create` requests.

15579 15693 

15694 When streaming, use the completed reasoning item and its

15695 `encrypted_content` from the `response.output_item.done` event in

15696 subsequent requests. The `encrypted_content` in

15697 `response.output_item.added` may be incomplete. This is especially

15698 important when `store` is `false` or when using Zero Data Retention.

15699 

15580 - `status: optional "in_progress" or "completed" or "incomplete"`15700 - `status: optional "in_progress" or "completed" or "incomplete"`

15581 15701 

15582 The status of the item. One of `in_progress`, `completed`, or15702 The status of the item. One of `in_progress`, `completed`, or


16292 Unique identifier for the MCP tool call approval request.16412 Unique identifier for the MCP tool call approval request.

16293 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.16413 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

16294 16414 

16295 - `error: optional string or null`16415 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

16416 

16417 The error from the tool call, if any.

16418 

16419 - `string`

16296 16420 

16297 The error from the tool call, if any.16421 The error from the tool call, if any.

16298 16422 

16423 - `McpProtocolError object { code, message, type }`

16424 

16425 - `code: number`

16426 

16427 - `message: string`

16428 

16429 - `type: "mcp_protocol_error"`

16430 

16431 - `"mcp_protocol_error"`

16432 

16433 - `McpToolExecutionError object { content, type }`

16434 

16435 - `content: unknown`

16436 

16437 - `type: "mcp_tool_execution_error"`

16438 

16439 - `"mcp_tool_execution_error"`

16440 

16441 - `HTTPError object { code, message, type }`

16442 

16443 - `code: number`

16444 

16445 - `message: string`

16446 

16447 - `type: "http_error"`

16448 

16449 - `"http_error"`

16450 

16299 - `output: optional string or null`16451 - `output: optional string or null`

16300 16452 

16301 The output from the tool call.16453 The output from the tool call.


19616 for reasoning items returned by `POST /v1/responses` and WebSocket19768 for reasoning items returned by `POST /v1/responses` and WebSocket

19617 `response.create` requests.19769 `response.create` requests.

19618 19770 

19771 When streaming, use the completed reasoning item and its

19772 `encrypted_content` from the `response.output_item.done` event in

19773 subsequent requests. The `encrypted_content` in

19774 `response.output_item.added` may be incomplete. This is especially

19775 important when `store` is `false` or when using Zero Data Retention.

19776 

19619 - `status: optional "in_progress" or "completed" or "incomplete"`19777 - `status: optional "in_progress" or "completed" or "incomplete"`

19620 19778 

19621 The status of the item. One of `in_progress`, `completed`, or19779 The status of the item. One of `in_progress`, `completed`, or


20331 Unique identifier for the MCP tool call approval request.20489 Unique identifier for the MCP tool call approval request.

20332 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.20490 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

20333 20491 

20334 - `error: optional string or null`20492 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

20335 20493 

20336 The error from the tool call, if any.20494 The error from the tool call, if any.

20337 20495 

20496 - `string`

20497 

20498 The error from the tool call, if any.

20499 

20500 - `McpProtocolError object { code, message, type }`

20501 

20502 - `code: number`

20503 

20504 - `message: string`

20505 

20506 - `type: "mcp_protocol_error"`

20507 

20508 - `"mcp_protocol_error"`

20509 

20510 - `McpToolExecutionError object { content, type }`

20511 

20512 - `content: unknown`

20513 

20514 - `type: "mcp_tool_execution_error"`

20515 

20516 - `"mcp_tool_execution_error"`

20517 

20518 - `HTTPError object { code, message, type }`

20519 

20520 - `code: number`

20521 

20522 - `message: string`

20523 

20524 - `type: "http_error"`

20525 

20526 - `"http_error"`

20527 

20338 - `output: optional string or null`20528 - `output: optional string or null`

20339 20529 

20340 The output from the tool call.20530 The output from the tool call.


23608 for reasoning items returned by `POST /v1/responses` and WebSocket23798 for reasoning items returned by `POST /v1/responses` and WebSocket

23609 `response.create` requests.23799 `response.create` requests.

23610 23800 

23801 When streaming, use the completed reasoning item and its

23802 `encrypted_content` from the `response.output_item.done` event in

23803 subsequent requests. The `encrypted_content` in

23804 `response.output_item.added` may be incomplete. This is especially

23805 important when `store` is `false` or when using Zero Data Retention.

23806 

23611 - `status: optional "in_progress" or "completed" or "incomplete"`23807 - `status: optional "in_progress" or "completed" or "incomplete"`

23612 23808 

23613 The status of the item. One of `in_progress`, `completed`, or23809 The status of the item. One of `in_progress`, `completed`, or


24323 Unique identifier for the MCP tool call approval request.24519 Unique identifier for the MCP tool call approval request.

24324 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.24520 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

24325 24521 

24326 - `error: optional string or null`24522 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

24523 

24524 The error from the tool call, if any.

24525 

24526 - `string`

24327 24527 

24328 The error from the tool call, if any.24528 The error from the tool call, if any.

24329 24529 

24530 - `McpProtocolError object { code, message, type }`

24531 

24532 - `code: number`

24533 

24534 - `message: string`

24535 

24536 - `type: "mcp_protocol_error"`

24537 

24538 - `"mcp_protocol_error"`

24539 

24540 - `McpToolExecutionError object { content, type }`

24541 

24542 - `content: unknown`

24543 

24544 - `type: "mcp_tool_execution_error"`

24545 

24546 - `"mcp_tool_execution_error"`

24547 

24548 - `HTTPError object { code, message, type }`

24549 

24550 - `code: number`

24551 

24552 - `message: string`

24553 

24554 - `type: "http_error"`

24555 

24556 - `"http_error"`

24557 

24330 - `output: optional string or null`24558 - `output: optional string or null`

24331 24559 

24332 The output from the tool call.24560 The output from the tool call.

Details

3202 for reasoning items returned by `POST /v1/responses` and WebSocket3202 for reasoning items returned by `POST /v1/responses` and WebSocket

3203 `response.create` requests.3203 `response.create` requests.

3204 3204 

3205 When streaming, use the completed reasoning item and its

3206 `encrypted_content` from the `response.output_item.done` event in

3207 subsequent requests. The `encrypted_content` in

3208 `response.output_item.added` may be incomplete. This is especially

3209 important when `store` is `false` or when using Zero Data Retention.

3210 

3205 - `status: optional "in_progress" or "completed" or "incomplete"`3211 - `status: optional "in_progress" or "completed" or "incomplete"`

3206 3212 

3207 The status of the item. One of `in_progress`, `completed`, or3213 The status of the item. One of `in_progress`, `completed`, or


3871 Unique identifier for the MCP tool call approval request.3877 Unique identifier for the MCP tool call approval request.

3872 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.3878 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

3873 3879 

3874 - `error: optional string or null`3880 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

3881 

3882 The error from the tool call, if any.

3883 

3884 - `string`

3875 3885 

3876 The error from the tool call, if any.3886 The error from the tool call, if any.

3877 3887 

3888 - `McpProtocolError object { code, message, type }`

3889 

3890 - `code: number`

3891 

3892 - `message: string`

3893 

3894 - `type: "mcp_protocol_error"`

3895 

3896 - `"mcp_protocol_error"`

3897 

3898 - `McpToolExecutionError object { content, type }`

3899 

3900 - `content: unknown`

3901 

3902 - `type: "mcp_tool_execution_error"`

3903 

3904 - `"mcp_tool_execution_error"`

3905 

3906 - `HTTPError object { code, message, type }`

3907 

3908 - `code: number`

3909 

3910 - `message: string`

3911 

3912 - `type: "http_error"`

3913 

3914 - `"http_error"`

3915 

3878 - `output: optional string or null`3916 - `output: optional string or null`

3879 3917 

3880 The output from the tool call.3918 The output from the tool call.


7224 for reasoning items returned by `POST /v1/responses` and WebSocket7262 for reasoning items returned by `POST /v1/responses` and WebSocket

7225 `response.create` requests.7263 `response.create` requests.

7226 7264 

7265 When streaming, use the completed reasoning item and its

7266 `encrypted_content` from the `response.output_item.done` event in

7267 subsequent requests. The `encrypted_content` in

7268 `response.output_item.added` may be incomplete. This is especially

7269 important when `store` is `false` or when using Zero Data Retention.

7270 

7227 - `status: optional "in_progress" or "completed" or "incomplete"`7271 - `status: optional "in_progress" or "completed" or "incomplete"`

7228 7272 

7229 The status of the item. One of `in_progress`, `completed`, or7273 The status of the item. One of `in_progress`, `completed`, or


7939 Unique identifier for the MCP tool call approval request.7983 Unique identifier for the MCP tool call approval request.

7940 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.7984 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

7941 7985 

7942 - `error: optional string or null`7986 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

7987 

7988 The error from the tool call, if any.

7989 

7990 - `string`

7943 7991 

7944 The error from the tool call, if any.7992 The error from the tool call, if any.

7945 7993 

7994 - `McpProtocolError object { code, message, type }`

7995 

7996 - `code: number`

7997 

7998 - `message: string`

7999 

8000 - `type: "mcp_protocol_error"`

8001 

8002 - `"mcp_protocol_error"`

8003 

8004 - `McpToolExecutionError object { content, type }`

8005 

8006 - `content: unknown`

8007 

8008 - `type: "mcp_tool_execution_error"`

8009 

8010 - `"mcp_tool_execution_error"`

8011 

8012 - `HTTPError object { code, message, type }`

8013 

8014 - `code: number`

8015 

8016 - `message: string`

8017 

8018 - `type: "http_error"`

8019 

8020 - `"http_error"`

8021 

7946 - `output: optional string or null`8022 - `output: optional string or null`

7947 8023 

7948 The output from the tool call.8024 The output from the tool call.

Details

3196 for reasoning items returned by `POST /v1/responses` and WebSocket3196 for reasoning items returned by `POST /v1/responses` and WebSocket

3197 `response.create` requests.3197 `response.create` requests.

3198 3198 

3199 When streaming, use the completed reasoning item and its

3200 `encrypted_content` from the `response.output_item.done` event in

3201 subsequent requests. The `encrypted_content` in

3202 `response.output_item.added` may be incomplete. This is especially

3203 important when `store` is `false` or when using Zero Data Retention.

3204 

3199 - `status: optional "in_progress" or "completed" or "incomplete"`3205 - `status: optional "in_progress" or "completed" or "incomplete"`

3200 3206 

3201 The status of the item. One of `in_progress`, `completed`, or3207 The status of the item. One of `in_progress`, `completed`, or


3911 Unique identifier for the MCP tool call approval request.3917 Unique identifier for the MCP tool call approval request.

3912 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.3918 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

3913 3919 

3914 - `error: optional string or null`3920 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

3921 

3922 The error from the tool call, if any.

3923 

3924 - `string`

3915 3925 

3916 The error from the tool call, if any.3926 The error from the tool call, if any.

3917 3927 

3928 - `McpProtocolError object { code, message, type }`

3929 

3930 - `code: number`

3931 

3932 - `message: string`

3933 

3934 - `type: "mcp_protocol_error"`

3935 

3936 - `"mcp_protocol_error"`

3937 

3938 - `McpToolExecutionError object { content, type }`

3939 

3940 - `content: unknown`

3941 

3942 - `type: "mcp_tool_execution_error"`

3943 

3944 - `"mcp_tool_execution_error"`

3945 

3946 - `HTTPError object { code, message, type }`

3947 

3948 - `code: number`

3949 

3950 - `message: string`

3951 

3952 - `type: "http_error"`

3953 

3954 - `"http_error"`

3955 

3918 - `output: optional string or null`3956 - `output: optional string or null`

3919 3957 

3920 The output from the tool call.3958 The output from the tool call.

Details

3167 for reasoning items returned by `POST /v1/responses` and WebSocket3167 for reasoning items returned by `POST /v1/responses` and WebSocket

3168 `response.create` requests.3168 `response.create` requests.

3169 3169 

3170 When streaming, use the completed reasoning item and its

3171 `encrypted_content` from the `response.output_item.done` event in

3172 subsequent requests. The `encrypted_content` in

3173 `response.output_item.added` may be incomplete. This is especially

3174 important when `store` is `false` or when using Zero Data Retention.

3175 

3170 - `status: optional "in_progress" or "completed" or "incomplete"`3176 - `status: optional "in_progress" or "completed" or "incomplete"`

3171 3177 

3172 The status of the item. One of `in_progress`, `completed`, or3178 The status of the item. One of `in_progress`, `completed`, or


3882 Unique identifier for the MCP tool call approval request.3888 Unique identifier for the MCP tool call approval request.

3883 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.3889 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

3884 3890 

3885 - `error: optional string or null`3891 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

3892 

3893 The error from the tool call, if any.

3894 

3895 - `string`

3886 3896 

3887 The error from the tool call, if any.3897 The error from the tool call, if any.

3888 3898 

3899 - `McpProtocolError object { code, message, type }`

3900 

3901 - `code: number`

3902 

3903 - `message: string`

3904 

3905 - `type: "mcp_protocol_error"`

3906 

3907 - `"mcp_protocol_error"`

3908 

3909 - `McpToolExecutionError object { content, type }`

3910 

3911 - `content: unknown`

3912 

3913 - `type: "mcp_tool_execution_error"`

3914 

3915 - `"mcp_tool_execution_error"`

3916 

3917 - `HTTPError object { code, message, type }`

3918 

3919 - `code: number`

3920 

3921 - `message: string`

3922 

3923 - `type: "http_error"`

3924 

3925 - `"http_error"`

3926 

3889 - `output: optional string or null`3927 - `output: optional string or null`

3890 3928 

3891 The output from the tool call.3929 The output from the tool call.

Details

84 84 

85 The organization that owns the model.85 The organization that owns the model.

86 86 

87 - `shutdown_date: optional string or null`

88 

89 The date when the model will shut down, or null if not announced.

90 

87- `object: "list"`91- `object: "list"`

88 92 

89 - `"list"`93 - `"list"`


104 "id": "id",108 "id": "id",

105 "created": 0,109 "created": 0,

106 "object": "model",110 "object": "model",

107 "owned_by": "owned_by"111 "owned_by": "owned_by",

112 "shutdown_date": "2019-12-27"

108 }113 }

109 ],114 ],

110 "object": "list"115 "object": "list"


128 "id": "model-id-0",133 "id": "model-id-0",

129 "object": "model",134 "object": "model",

130 "created": 1686935002,135 "created": 1686935002,

131 "owned_by": "organization-owner"136 "owned_by": "organization-owner",

137 "shutdown_date": null

132 },138 },

133 {139 {

134 "id": "model-id-1",140 "id": "model-id-1",

135 "object": "model",141 "object": "model",

136 "created": 1686935002,142 "created": 1686935002,

137 "owned_by": "organization-owner",143 "owned_by": "organization-owner",

144 "shutdown_date": null

138 },145 },

139 {146 {

140 "id": "model-id-2",147 "id": "model-id-2",

141 "object": "model",148 "object": "model",

142 "created": 1686935002,149 "created": 1686935002,

143 "owned_by": "openai"150 "owned_by": "openai",

151 "shutdown_date": "2026-10-23"

144 },152 },

145 ]153 ]

146}154}


158 166 

159### Returns167### Returns

160 168 

161- `Model object { id, created, object, owned_by }`169- `Model object { id, created, object, 2 more }`

162 170 

163 Describes an OpenAI model offering that can be used with the API.171 Describes an OpenAI model offering that can be used with the API.

164 172 


180 188 

181 The organization that owns the model.189 The organization that owns the model.

182 190 

191 - `shutdown_date: optional string or null`

192 

193 The date when the model will shut down, or null if not announced.

194 

183### Example195### Example

184 196 

185```http197```http


194 "id": "id",206 "id": "id",

195 "created": 0,207 "created": 0,

196 "object": "model",208 "object": "model",

197 "owned_by": "owned_by"209 "owned_by": "owned_by",

210 "shutdown_date": "2019-12-27"

198}211}

199```212```

200 213 


212 "id": "VAR_chat_model_id",225 "id": "VAR_chat_model_id",

213 "object": "model",226 "object": "model",

214 "created": 1686935002,227 "created": 1686935002,

215 "owned_by": "openai"228 "owned_by": "openai",

229 "shutdown_date": "2026-10-23"

216}230}

217```231```

218 232 


220 234 

221### Model235### Model

222 236 

223- `Model object { id, created, object, owned_by }`237- `Model object { id, created, object, 2 more }`

224 238 

225 Describes an OpenAI model offering that can be used with the API.239 Describes an OpenAI model offering that can be used with the API.

226 240 


242 256 

243 The organization that owns the model.257 The organization that owns the model.

244 258 

259 - `shutdown_date: optional string or null`

260 

261 The date when the model will shut down, or null if not announced.

262 

245### Model Deleted263### Model Deleted

246 264 

247- `ModelDeleted object { id, deleted, object }`265- `ModelDeleted object { id, deleted, object }`

Details

26 26 

27 The organization that owns the model.27 The organization that owns the model.

28 28 

29 - `shutdown_date: optional string or null`

30 

31 The date when the model will shut down, or null if not announced.

32 

29- `object: "list"`33- `object: "list"`

30 34 

31 - `"list"`35 - `"list"`


46 "id": "id",50 "id": "id",

47 "created": 0,51 "created": 0,

48 "object": "model",52 "object": "model",

49 "owned_by": "owned_by"53 "owned_by": "owned_by",

54 "shutdown_date": "2019-12-27"

50 }55 }

51 ],56 ],

52 "object": "list"57 "object": "list"


70 "id": "model-id-0",75 "id": "model-id-0",

71 "object": "model",76 "object": "model",

72 "created": 1686935002,77 "created": 1686935002,

73 "owned_by": "organization-owner"78 "owned_by": "organization-owner",

79 "shutdown_date": null

74 },80 },

75 {81 {

76 "id": "model-id-1",82 "id": "model-id-1",

77 "object": "model",83 "object": "model",

78 "created": 1686935002,84 "created": 1686935002,

79 "owned_by": "organization-owner",85 "owned_by": "organization-owner",

86 "shutdown_date": null

80 },87 },

81 {88 {

82 "id": "model-id-2",89 "id": "model-id-2",

83 "object": "model",90 "object": "model",

84 "created": 1686935002,91 "created": 1686935002,

85 "owned_by": "openai"92 "owned_by": "openai",

93 "shutdown_date": "2026-10-23"

86 },94 },

87 ]95 ]

88}96}

Details

10 10 

11### Returns11### Returns

12 12 

13- `Model object { id, created, object, owned_by }`13- `Model object { id, created, object, 2 more }`

14 14 

15 Describes an OpenAI model offering that can be used with the API.15 Describes an OpenAI model offering that can be used with the API.

16 16 


32 32 

33 The organization that owns the model.33 The organization that owns the model.

34 34 

35 - `shutdown_date: optional string or null`

36 

37 The date when the model will shut down, or null if not announced.

38 

35### Example39### Example

36 40 

37```http41```http


46 "id": "id",50 "id": "id",

47 "created": 0,51 "created": 0,

48 "object": "model",52 "object": "model",

49 "owned_by": "owned_by"53 "owned_by": "owned_by",

54 "shutdown_date": "2019-12-27"

50}55}

51```56```

52 57 


64 "id": "VAR_chat_model_id",69 "id": "VAR_chat_model_id",

65 "object": "model",70 "object": "model",

66 "created": 1686935002,71 "created": 1686935002,

67 "owned_by": "openai"72 "owned_by": "openai",

73 "shutdown_date": "2026-10-23"

68}74}

69```75```

Details

3271 for reasoning items returned by `POST /v1/responses` and WebSocket3271 for reasoning items returned by `POST /v1/responses` and WebSocket

3272 `response.create` requests.3272 `response.create` requests.

3273 3273 

3274 When streaming, use the completed reasoning item and its

3275 `encrypted_content` from the `response.output_item.done` event in

3276 subsequent requests. The `encrypted_content` in

3277 `response.output_item.added` may be incomplete. This is especially

3278 important when `store` is `false` or when using Zero Data Retention.

3279 

3274 - `status: optional "in_progress" or "completed" or "incomplete"`3280 - `status: optional "in_progress" or "completed" or "incomplete"`

3275 3281 

3276 The status of the item. One of `in_progress`, `completed`, or3282 The status of the item. One of `in_progress`, `completed`, or


3940 Unique identifier for the MCP tool call approval request.3946 Unique identifier for the MCP tool call approval request.

3941 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.3947 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

3942 3948 

3943 - `error: optional string or null`3949 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

3944 3950 

3945 The error from the tool call, if any.3951 The error from the tool call, if any.

3946 3952 

3953 - `string`

3954 

3955 The error from the tool call, if any.

3956 

3957 - `McpProtocolError object { code, message, type }`

3958 

3959 - `code: number`

3960 

3961 - `message: string`

3962 

3963 - `type: "mcp_protocol_error"`

3964 

3965 - `"mcp_protocol_error"`

3966 

3967 - `McpToolExecutionError object { content, type }`

3968 

3969 - `content: unknown`

3970 

3971 - `type: "mcp_tool_execution_error"`

3972 

3973 - `"mcp_tool_execution_error"`

3974 

3975 - `HTTPError object { code, message, type }`

3976 

3977 - `code: number`

3978 

3979 - `message: string`

3980 

3981 - `type: "http_error"`

3982 

3983 - `"http_error"`

3984 

3947 - `output: optional string or null`3985 - `output: optional string or null`

3948 3986 

3949 The output from the tool call.3987 The output from the tool call.


4874 for reasoning items returned by `POST /v1/responses` and WebSocket4912 for reasoning items returned by `POST /v1/responses` and WebSocket

4875 `response.create` requests.4913 `response.create` requests.

4876 4914 

4915 When streaming, use the completed reasoning item and its

4916 `encrypted_content` from the `response.output_item.done` event in

4917 subsequent requests. The `encrypted_content` in

4918 `response.output_item.added` may be incomplete. This is especially

4919 important when `store` is `false` or when using Zero Data Retention.

4920 

4877 - `status: optional "in_progress" or "completed" or "incomplete"`4921 - `status: optional "in_progress" or "completed" or "incomplete"`

4878 4922 

4879 The status of the item. One of `in_progress`, `completed`, or4923 The status of the item. One of `in_progress`, `completed`, or


7271 Unique identifier for the MCP tool call approval request.7315 Unique identifier for the MCP tool call approval request.

7272 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.7316 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

7273 7317 

7274 - `error: optional string or null`7318 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

7319 

7320 The error from the tool call, if any.

7321 

7322 - `string`

7275 7323 

7276 The error from the tool call, if any.7324 The error from the tool call, if any.

7277 7325 

7326 - `McpProtocolError object { code, message, type }`

7327 

7328 - `code: number`

7329 

7330 - `message: string`

7331 

7332 - `type: "mcp_protocol_error"`

7333 

7334 - `"mcp_protocol_error"`

7335 

7336 - `McpToolExecutionError object { content, type }`

7337 

7338 - `content: unknown`

7339 

7340 - `type: "mcp_tool_execution_error"`

7341 

7342 - `"mcp_tool_execution_error"`

7343 

7344 - `HTTPError object { code, message, type }`

7345 

7346 - `code: number`

7347 

7348 - `message: string`

7349 

7350 - `type: "http_error"`

7351 

7352 - `"http_error"`

7353 

7278 - `output: optional string or null`7354 - `output: optional string or null`

7279 7355 

7280 The output from the tool call.7356 The output from the tool call.


12709 for reasoning items returned by `POST /v1/responses` and WebSocket12785 for reasoning items returned by `POST /v1/responses` and WebSocket

12710 `response.create` requests.12786 `response.create` requests.

12711 12787 

12788 When streaming, use the completed reasoning item and its

12789 `encrypted_content` from the `response.output_item.done` event in

12790 subsequent requests. The `encrypted_content` in

12791 `response.output_item.added` may be incomplete. This is especially

12792 important when `store` is `false` or when using Zero Data Retention.

12793 

12712 - `status: optional "in_progress" or "completed" or "incomplete"`12794 - `status: optional "in_progress" or "completed" or "incomplete"`

12713 12795 

12714 The status of the item. One of `in_progress`, `completed`, or12796 The status of the item. One of `in_progress`, `completed`, or


13378 Unique identifier for the MCP tool call approval request.13460 Unique identifier for the MCP tool call approval request.

13379 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.13461 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

13380 13462 

13381 - `error: optional string or null`13463 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

13464 

13465 The error from the tool call, if any.

13466 

13467 - `string`

13382 13468 

13383 The error from the tool call, if any.13469 The error from the tool call, if any.

13384 13470 

13471 - `McpProtocolError object { code, message, type }`

13472 

13473 - `code: number`

13474 

13475 - `message: string`

13476 

13477 - `type: "mcp_protocol_error"`

13478 

13479 - `"mcp_protocol_error"`

13480 

13481 - `McpToolExecutionError object { content, type }`

13482 

13483 - `content: unknown`

13484 

13485 - `type: "mcp_tool_execution_error"`

13486 

13487 - `"mcp_tool_execution_error"`

13488 

13489 - `HTTPError object { code, message, type }`

13490 

13491 - `code: number`

13492 

13493 - `message: string`

13494 

13495 - `type: "http_error"`

13496 

13497 - `"http_error"`

13498 

13385 - `output: optional string or null`13499 - `output: optional string or null`

13386 13500 

13387 The output from the tool call.13501 The output from the tool call.


16847 for reasoning items returned by `POST /v1/responses` and WebSocket16961 for reasoning items returned by `POST /v1/responses` and WebSocket

16848 `response.create` requests.16962 `response.create` requests.

16849 16963 

16964 When streaming, use the completed reasoning item and its

16965 `encrypted_content` from the `response.output_item.done` event in

16966 subsequent requests. The `encrypted_content` in

16967 `response.output_item.added` may be incomplete. This is especially

16968 important when `store` is `false` or when using Zero Data Retention.

16969 

16850 - `status: optional "in_progress" or "completed" or "incomplete"`16970 - `status: optional "in_progress" or "completed" or "incomplete"`

16851 16971 

16852 The status of the item. One of `in_progress`, `completed`, or16972 The status of the item. One of `in_progress`, `completed`, or


17510 Unique identifier for the MCP tool call approval request.17630 Unique identifier for the MCP tool call approval request.

17511 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.17631 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

17512 17632 

17513 - `error: optional string or null`17633 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

17514 17634 

17515 The error from the tool call, if any.17635 The error from the tool call, if any.

17516 17636 

17637 - `string`

17638 

17639 The error from the tool call, if any.

17640 

17641 - `McpProtocolError object { code, message, type }`

17642 

17643 - `code: number`

17644 

17645 - `message: string`

17646 

17647 - `type: "mcp_protocol_error"`

17648 

17649 - `"mcp_protocol_error"`

17650 

17651 - `McpToolExecutionError object { content, type }`

17652 

17653 - `content: unknown`

17654 

17655 - `type: "mcp_tool_execution_error"`

17656 

17657 - `"mcp_tool_execution_error"`

17658 

17659 - `HTTPError object { code, message, type }`

17660 

17661 - `code: number`

17662 

17663 - `message: string`

17664 

17665 - `type: "http_error"`

17666 

17667 - `"http_error"`

17668 

17517 - `output: optional string or null`17669 - `output: optional string or null`

17518 17670 

17519 The output from the tool call.17671 The output from the tool call.


21073 for reasoning items returned by `POST /v1/responses` and WebSocket21225 for reasoning items returned by `POST /v1/responses` and WebSocket

21074 `response.create` requests.21226 `response.create` requests.

21075 21227 

21228 When streaming, use the completed reasoning item and its

21229 `encrypted_content` from the `response.output_item.done` event in

21230 subsequent requests. The `encrypted_content` in

21231 `response.output_item.added` may be incomplete. This is especially

21232 important when `store` is `false` or when using Zero Data Retention.

21233 

21076 - `status: optional "in_progress" or "completed" or "incomplete"`21234 - `status: optional "in_progress" or "completed" or "incomplete"`

21077 21235 

21078 The status of the item. One of `in_progress`, `completed`, or21236 The status of the item. One of `in_progress`, `completed`, or


21742 Unique identifier for the MCP tool call approval request.21900 Unique identifier for the MCP tool call approval request.

21743 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.21901 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

21744 21902 

21745 - `error: optional string or null`21903 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

21904 

21905 The error from the tool call, if any.

21906 

21907 - `string`

21746 21908 

21747 The error from the tool call, if any.21909 The error from the tool call, if any.

21748 21910 

21911 - `McpProtocolError object { code, message, type }`

21912 

21913 - `code: number`

21914 

21915 - `message: string`

21916 

21917 - `type: "mcp_protocol_error"`

21918 

21919 - `"mcp_protocol_error"`

21920 

21921 - `McpToolExecutionError object { content, type }`

21922 

21923 - `content: unknown`

21924 

21925 - `type: "mcp_tool_execution_error"`

21926 

21927 - `"mcp_tool_execution_error"`

21928 

21929 - `HTTPError object { code, message, type }`

21930 

21931 - `code: number`

21932 

21933 - `message: string`

21934 

21935 - `type: "http_error"`

21936 

21937 - `"http_error"`

21938 

21749 - `output: optional string or null`21939 - `output: optional string or null`

21750 21940 

21751 The output from the tool call.21941 The output from the tool call.


26863 for reasoning items returned by `POST /v1/responses` and WebSocket27053 for reasoning items returned by `POST /v1/responses` and WebSocket

26864 `response.create` requests.27054 `response.create` requests.

26865 27055 

27056 When streaming, use the completed reasoning item and its

27057 `encrypted_content` from the `response.output_item.done` event in

27058 subsequent requests. The `encrypted_content` in

27059 `response.output_item.added` may be incomplete. This is especially

27060 important when `store` is `false` or when using Zero Data Retention.

27061 

26866 - `status: optional "in_progress" or "completed" or "incomplete"`27062 - `status: optional "in_progress" or "completed" or "incomplete"`

26867 27063 

26868 The status of the item. One of `in_progress`, `completed`, or27064 The status of the item. One of `in_progress`, `completed`, or


27532 Unique identifier for the MCP tool call approval request.27728 Unique identifier for the MCP tool call approval request.

27533 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.27729 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

27534 27730 

27535 - `error: optional string or null`27731 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

27732 

27733 The error from the tool call, if any.

27734 

27735 - `string`

27536 27736 

27537 The error from the tool call, if any.27737 The error from the tool call, if any.

27538 27738 

27739 - `McpProtocolError object { code, message, type }`

27740 

27741 - `code: number`

27742 

27743 - `message: string`

27744 

27745 - `type: "mcp_protocol_error"`

27746 

27747 - `"mcp_protocol_error"`

27748 

27749 - `McpToolExecutionError object { content, type }`

27750 

27751 - `content: unknown`

27752 

27753 - `type: "mcp_tool_execution_error"`

27754 

27755 - `"mcp_tool_execution_error"`

27756 

27757 - `HTTPError object { code, message, type }`

27758 

27759 - `code: number`

27760 

27761 - `message: string`

27762 

27763 - `type: "http_error"`

27764 

27765 - `"http_error"`

27766 

27539 - `output: optional string or null`27767 - `output: optional string or null`

27540 27768 

27541 The output from the tool call.27769 The output from the tool call.


28466 for reasoning items returned by `POST /v1/responses` and WebSocket28694 for reasoning items returned by `POST /v1/responses` and WebSocket

28467 `response.create` requests.28695 `response.create` requests.

28468 28696 

28697 When streaming, use the completed reasoning item and its

28698 `encrypted_content` from the `response.output_item.done` event in

28699 subsequent requests. The `encrypted_content` in

28700 `response.output_item.added` may be incomplete. This is especially

28701 important when `store` is `false` or when using Zero Data Retention.

28702 

28469 - `status: optional "in_progress" or "completed" or "incomplete"`28703 - `status: optional "in_progress" or "completed" or "incomplete"`

28470 28704 

28471 The status of the item. One of `in_progress`, `completed`, or28705 The status of the item. One of `in_progress`, `completed`, or


30863 Unique identifier for the MCP tool call approval request.31097 Unique identifier for the MCP tool call approval request.

30864 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.31098 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

30865 31099 

30866 - `error: optional string or null`31100 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

30867 31101 

30868 The error from the tool call, if any.31102 The error from the tool call, if any.

30869 31103 

31104 - `string`

31105 

31106 The error from the tool call, if any.

31107 

31108 - `McpProtocolError object { code, message, type }`

31109 

31110 - `code: number`

31111 

31112 - `message: string`

31113 

31114 - `type: "mcp_protocol_error"`

31115 

31116 - `"mcp_protocol_error"`

31117 

31118 - `McpToolExecutionError object { content, type }`

31119 

31120 - `content: unknown`

31121 

31122 - `type: "mcp_tool_execution_error"`

31123 

31124 - `"mcp_tool_execution_error"`

31125 

31126 - `HTTPError object { code, message, type }`

31127 

31128 - `code: number`

31129 

31130 - `message: string`

31131 

31132 - `type: "http_error"`

31133 

31134 - `"http_error"`

31135 

30870 - `output: optional string or null`31136 - `output: optional string or null`

30871 31137 

30872 The output from the tool call.31138 The output from the tool call.


36958 for reasoning items returned by `POST /v1/responses` and WebSocket37224 for reasoning items returned by `POST /v1/responses` and WebSocket

36959 `response.create` requests.37225 `response.create` requests.

36960 37226 

37227 When streaming, use the completed reasoning item and its

37228 `encrypted_content` from the `response.output_item.done` event in

37229 subsequent requests. The `encrypted_content` in

37230 `response.output_item.added` may be incomplete. This is especially

37231 important when `store` is `false` or when using Zero Data Retention.

37232 

36961 - `status: optional "in_progress" or "completed" or "incomplete"`37233 - `status: optional "in_progress" or "completed" or "incomplete"`

36962 37234 

36963 The status of the item. One of `in_progress`, `completed`, or37235 The status of the item. One of `in_progress`, `completed`, or


37627 Unique identifier for the MCP tool call approval request.37899 Unique identifier for the MCP tool call approval request.

37628 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.37900 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

37629 37901 

37630 - `error: optional string or null`37902 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

37903 

37904 The error from the tool call, if any.

37905 

37906 - `string`

37631 37907 

37632 The error from the tool call, if any.37908 The error from the tool call, if any.

37633 37909 

37910 - `McpProtocolError object { code, message, type }`

37911 

37912 - `code: number`

37913 

37914 - `message: string`

37915 

37916 - `type: "mcp_protocol_error"`

37917 

37918 - `"mcp_protocol_error"`

37919 

37920 - `McpToolExecutionError object { content, type }`

37921 

37922 - `content: unknown`

37923 

37924 - `type: "mcp_tool_execution_error"`

37925 

37926 - `"mcp_tool_execution_error"`

37927 

37928 - `HTTPError object { code, message, type }`

37929 

37930 - `code: number`

37931 

37932 - `message: string`

37933 

37934 - `type: "http_error"`

37935 

37936 - `"http_error"`

37937 

37634 - `output: optional string or null`37938 - `output: optional string or null`

37635 37939 

37636 The output from the tool call.37940 The output from the tool call.


38561 for reasoning items returned by `POST /v1/responses` and WebSocket38865 for reasoning items returned by `POST /v1/responses` and WebSocket

38562 `response.create` requests.38866 `response.create` requests.

38563 38867 

38868 When streaming, use the completed reasoning item and its

38869 `encrypted_content` from the `response.output_item.done` event in

38870 subsequent requests. The `encrypted_content` in

38871 `response.output_item.added` may be incomplete. This is especially

38872 important when `store` is `false` or when using Zero Data Retention.

38873 

38564 - `status: optional "in_progress" or "completed" or "incomplete"`38874 - `status: optional "in_progress" or "completed" or "incomplete"`

38565 38875 

38566 The status of the item. One of `in_progress`, `completed`, or38876 The status of the item. One of `in_progress`, `completed`, or


40958 Unique identifier for the MCP tool call approval request.41268 Unique identifier for the MCP tool call approval request.

40959 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.41269 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

40960 41270 

40961 - `error: optional string or null`41271 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

41272 

41273 The error from the tool call, if any.

41274 

41275 - `string`

40962 41276 

40963 The error from the tool call, if any.41277 The error from the tool call, if any.

40964 41278 

41279 - `McpProtocolError object { code, message, type }`

41280 

41281 - `code: number`

41282 

41283 - `message: string`

41284 

41285 - `type: "mcp_protocol_error"`

41286 

41287 - `"mcp_protocol_error"`

41288 

41289 - `McpToolExecutionError object { content, type }`

41290 

41291 - `content: unknown`

41292 

41293 - `type: "mcp_tool_execution_error"`

41294 

41295 - `"mcp_tool_execution_error"`

41296 

41297 - `HTTPError object { code, message, type }`

41298 

41299 - `code: number`

41300 

41301 - `message: string`

41302 

41303 - `type: "http_error"`

41304 

41305 - `"http_error"`

41306 

40965 - `output: optional string or null`41307 - `output: optional string or null`

40966 41308 

40967 The output from the tool call.41309 The output from the tool call.


46206 for reasoning items returned by `POST /v1/responses` and WebSocket46548 for reasoning items returned by `POST /v1/responses` and WebSocket

46207 `response.create` requests.46549 `response.create` requests.

46208 46550 

46551 When streaming, use the completed reasoning item and its

46552 `encrypted_content` from the `response.output_item.done` event in

46553 subsequent requests. The `encrypted_content` in

46554 `response.output_item.added` may be incomplete. This is especially

46555 important when `store` is `false` or when using Zero Data Retention.

46556 

46209 - `status: optional "in_progress" or "completed" or "incomplete"`46557 - `status: optional "in_progress" or "completed" or "incomplete"`

46210 46558 

46211 The status of the item. One of `in_progress`, `completed`, or46559 The status of the item. One of `in_progress`, `completed`, or


46869 Unique identifier for the MCP tool call approval request.47217 Unique identifier for the MCP tool call approval request.

46870 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.47218 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

46871 47219 

46872 - `error: optional string or null`47220 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

46873 47221 

46874 The error from the tool call, if any.47222 The error from the tool call, if any.

46875 47223 

47224 - `string`

47225 

47226 The error from the tool call, if any.

47227 

47228 - `McpProtocolError object { code, message, type }`

47229 

47230 - `code: number`

47231 

47232 - `message: string`

47233 

47234 - `type: "mcp_protocol_error"`

47235 

47236 - `"mcp_protocol_error"`

47237 

47238 - `McpToolExecutionError object { content, type }`

47239 

47240 - `content: unknown`

47241 

47242 - `type: "mcp_tool_execution_error"`

47243 

47244 - `"mcp_tool_execution_error"`

47245 

47246 - `HTTPError object { code, message, type }`

47247 

47248 - `code: number`

47249 

47250 - `message: string`

47251 

47252 - `type: "http_error"`

47253 

47254 - `"http_error"`

47255 

46876 - `output: optional string or null`47256 - `output: optional string or null`

46877 47257 

46878 The output from the tool call.47258 The output from the tool call.


51156 for reasoning items returned by `POST /v1/responses` and WebSocket51536 for reasoning items returned by `POST /v1/responses` and WebSocket

51157 `response.create` requests.51537 `response.create` requests.

51158 51538 

51539 When streaming, use the completed reasoning item and its

51540 `encrypted_content` from the `response.output_item.done` event in

51541 subsequent requests. The `encrypted_content` in

51542 `response.output_item.added` may be incomplete. This is especially

51543 important when `store` is `false` or when using Zero Data Retention.

51544 

51159 - `status: optional "in_progress" or "completed" or "incomplete"`51545 - `status: optional "in_progress" or "completed" or "incomplete"`

51160 51546 

51161 The status of the item. One of `in_progress`, `completed`, or51547 The status of the item. One of `in_progress`, `completed`, or


51825 Unique identifier for the MCP tool call approval request.52211 Unique identifier for the MCP tool call approval request.

51826 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.52212 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

51827 52213 

51828 - `error: optional string or null`52214 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

52215 

52216 The error from the tool call, if any.

52217 

52218 - `string`

51829 52219 

51830 The error from the tool call, if any.52220 The error from the tool call, if any.

51831 52221 

52222 - `McpProtocolError object { code, message, type }`

52223 

52224 - `code: number`

52225 

52226 - `message: string`

52227 

52228 - `type: "mcp_protocol_error"`

52229 

52230 - `"mcp_protocol_error"`

52231 

52232 - `McpToolExecutionError object { content, type }`

52233 

52234 - `content: unknown`

52235 

52236 - `type: "mcp_tool_execution_error"`

52237 

52238 - `"mcp_tool_execution_error"`

52239 

52240 - `HTTPError object { code, message, type }`

52241 

52242 - `code: number`

52243 

52244 - `message: string`

52245 

52246 - `type: "http_error"`

52247 

52248 - `"http_error"`

52249 

51832 - `output: optional string or null`52250 - `output: optional string or null`

51833 52251 

51834 The output from the tool call.52252 The output from the tool call.


52759 for reasoning items returned by `POST /v1/responses` and WebSocket53177 for reasoning items returned by `POST /v1/responses` and WebSocket

52760 `response.create` requests.53178 `response.create` requests.

52761 53179 

53180 When streaming, use the completed reasoning item and its

53181 `encrypted_content` from the `response.output_item.done` event in

53182 subsequent requests. The `encrypted_content` in

53183 `response.output_item.added` may be incomplete. This is especially

53184 important when `store` is `false` or when using Zero Data Retention.

53185 

52762 - `status: optional "in_progress" or "completed" or "incomplete"`53186 - `status: optional "in_progress" or "completed" or "incomplete"`

52763 53187 

52764 The status of the item. One of `in_progress`, `completed`, or53188 The status of the item. One of `in_progress`, `completed`, or


55156 Unique identifier for the MCP tool call approval request.55580 Unique identifier for the MCP tool call approval request.

55157 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.55581 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

55158 55582 

55159 - `error: optional string or null`55583 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

55584 

55585 The error from the tool call, if any.

55586 

55587 - `string`

55160 55588 

55161 The error from the tool call, if any.55589 The error from the tool call, if any.

55162 55590 

55591 - `McpProtocolError object { code, message, type }`

55592 

55593 - `code: number`

55594 

55595 - `message: string`

55596 

55597 - `type: "mcp_protocol_error"`

55598 

55599 - `"mcp_protocol_error"`

55600 

55601 - `McpToolExecutionError object { content, type }`

55602 

55603 - `content: unknown`

55604 

55605 - `type: "mcp_tool_execution_error"`

55606 

55607 - `"mcp_tool_execution_error"`

55608 

55609 - `HTTPError object { code, message, type }`

55610 

55611 - `code: number`

55612 

55613 - `message: string`

55614 

55615 - `type: "http_error"`

55616 

55617 - `"http_error"`

55618 

55163 - `output: optional string or null`55619 - `output: optional string or null`

55164 55620 

55165 The output from the tool call.55621 The output from the tool call.


60417 for reasoning items returned by `POST /v1/responses` and WebSocket60873 for reasoning items returned by `POST /v1/responses` and WebSocket

60418 `response.create` requests.60874 `response.create` requests.

60419 60875 

60876 When streaming, use the completed reasoning item and its

60877 `encrypted_content` from the `response.output_item.done` event in

60878 subsequent requests. The `encrypted_content` in

60879 `response.output_item.added` may be incomplete. This is especially

60880 important when `store` is `false` or when using Zero Data Retention.

60881 

60420 - `status: optional "in_progress" or "completed" or "incomplete"`60882 - `status: optional "in_progress" or "completed" or "incomplete"`

60421 60883 

60422 The status of the item. One of `in_progress`, `completed`, or60884 The status of the item. One of `in_progress`, `completed`, or


61086 Unique identifier for the MCP tool call approval request.61548 Unique identifier for the MCP tool call approval request.

61087 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.61549 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

61088 61550 

61089 - `error: optional string or null`61551 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

61090 61552 

61091 The error from the tool call, if any.61553 The error from the tool call, if any.

61092 61554 

61555 - `string`

61556 

61557 The error from the tool call, if any.

61558 

61559 - `McpProtocolError object { code, message, type }`

61560 

61561 - `code: number`

61562 

61563 - `message: string`

61564 

61565 - `type: "mcp_protocol_error"`

61566 

61567 - `"mcp_protocol_error"`

61568 

61569 - `McpToolExecutionError object { content, type }`

61570 

61571 - `content: unknown`

61572 

61573 - `type: "mcp_tool_execution_error"`

61574 

61575 - `"mcp_tool_execution_error"`

61576 

61577 - `HTTPError object { code, message, type }`

61578 

61579 - `code: number`

61580 

61581 - `message: string`

61582 

61583 - `type: "http_error"`

61584 

61585 - `"http_error"`

61586 

61093 - `output: optional string or null`61587 - `output: optional string or null`

61094 61588 

61095 The output from the tool call.61589 The output from the tool call.


62020 for reasoning items returned by `POST /v1/responses` and WebSocket62514 for reasoning items returned by `POST /v1/responses` and WebSocket

62021 `response.create` requests.62515 `response.create` requests.

62022 62516 

62517 When streaming, use the completed reasoning item and its

62518 `encrypted_content` from the `response.output_item.done` event in

62519 subsequent requests. The `encrypted_content` in

62520 `response.output_item.added` may be incomplete. This is especially

62521 important when `store` is `false` or when using Zero Data Retention.

62522 

62023 - `status: optional "in_progress" or "completed" or "incomplete"`62523 - `status: optional "in_progress" or "completed" or "incomplete"`

62024 62524 

62025 The status of the item. One of `in_progress`, `completed`, or62525 The status of the item. One of `in_progress`, `completed`, or


64417 Unique identifier for the MCP tool call approval request.64917 Unique identifier for the MCP tool call approval request.

64418 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.64918 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

64419 64919 

64420 - `error: optional string or null`64920 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

64921 

64922 The error from the tool call, if any.

64923 

64924 - `string`

64421 64925 

64422 The error from the tool call, if any.64926 The error from the tool call, if any.

64423 64927 

64928 - `McpProtocolError object { code, message, type }`

64929 

64930 - `code: number`

64931 

64932 - `message: string`

64933 

64934 - `type: "mcp_protocol_error"`

64935 

64936 - `"mcp_protocol_error"`

64937 

64938 - `McpToolExecutionError object { content, type }`

64939 

64940 - `content: unknown`

64941 

64942 - `type: "mcp_tool_execution_error"`

64943 

64944 - `"mcp_tool_execution_error"`

64945 

64946 - `HTTPError object { code, message, type }`

64947 

64948 - `code: number`

64949 

64950 - `message: string`

64951 

64952 - `type: "http_error"`

64953 

64954 - `"http_error"`

64955 

64424 - `output: optional string or null`64956 - `output: optional string or null`

64425 64957 

64426 The output from the tool call.64958 The output from the tool call.


70187 for reasoning items returned by `POST /v1/responses` and WebSocket70719 for reasoning items returned by `POST /v1/responses` and WebSocket

70188 `response.create` requests.70720 `response.create` requests.

70189 70721 

70722 When streaming, use the completed reasoning item and its

70723 `encrypted_content` from the `response.output_item.done` event in

70724 subsequent requests. The `encrypted_content` in

70725 `response.output_item.added` may be incomplete. This is especially

70726 important when `store` is `false` or when using Zero Data Retention.

70727 

70190 - `status: optional "in_progress" or "completed" or "incomplete"`70728 - `status: optional "in_progress" or "completed" or "incomplete"`

70191 70729 

70192 The status of the item. One of `in_progress`, `completed`, or70730 The status of the item. One of `in_progress`, `completed`, or


70856 Unique identifier for the MCP tool call approval request.71394 Unique identifier for the MCP tool call approval request.

70857 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.71395 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

70858 71396 

70859 - `error: optional string or null`71397 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

71398 

71399 The error from the tool call, if any.

71400 

71401 - `string`

70860 71402 

70861 The error from the tool call, if any.71403 The error from the tool call, if any.

70862 71404 

71405 - `McpProtocolError object { code, message, type }`

71406 

71407 - `code: number`

71408 

71409 - `message: string`

71410 

71411 - `type: "mcp_protocol_error"`

71412 

71413 - `"mcp_protocol_error"`

71414 

71415 - `McpToolExecutionError object { content, type }`

71416 

71417 - `content: unknown`

71418 

71419 - `type: "mcp_tool_execution_error"`

71420 

71421 - `"mcp_tool_execution_error"`

71422 

71423 - `HTTPError object { code, message, type }`

71424 

71425 - `code: number`

71426 

71427 - `message: string`

71428 

71429 - `type: "http_error"`

71430 

71431 - `"http_error"`

71432 

70863 - `output: optional string or null`71433 - `output: optional string or null`

70864 71434 

70865 The output from the tool call.71435 The output from the tool call.


71790 for reasoning items returned by `POST /v1/responses` and WebSocket72360 for reasoning items returned by `POST /v1/responses` and WebSocket

71791 `response.create` requests.72361 `response.create` requests.

71792 72362 

72363 When streaming, use the completed reasoning item and its

72364 `encrypted_content` from the `response.output_item.done` event in

72365 subsequent requests. The `encrypted_content` in

72366 `response.output_item.added` may be incomplete. This is especially

72367 important when `store` is `false` or when using Zero Data Retention.

72368 

71793 - `status: optional "in_progress" or "completed" or "incomplete"`72369 - `status: optional "in_progress" or "completed" or "incomplete"`

71794 72370 

71795 The status of the item. One of `in_progress`, `completed`, or72371 The status of the item. One of `in_progress`, `completed`, or


74187 Unique identifier for the MCP tool call approval request.74763 Unique identifier for the MCP tool call approval request.

74188 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.74764 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

74189 74765 

74190 - `error: optional string or null`74766 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

74191 74767 

74192 The error from the tool call, if any.74768 The error from the tool call, if any.

74193 74769 

74770 - `string`

74771 

74772 The error from the tool call, if any.

74773 

74774 - `McpProtocolError object { code, message, type }`

74775 

74776 - `code: number`

74777 

74778 - `message: string`

74779 

74780 - `type: "mcp_protocol_error"`

74781 

74782 - `"mcp_protocol_error"`

74783 

74784 - `McpToolExecutionError object { content, type }`

74785 

74786 - `content: unknown`

74787 

74788 - `type: "mcp_tool_execution_error"`

74789 

74790 - `"mcp_tool_execution_error"`

74791 

74792 - `HTTPError object { code, message, type }`

74793 

74794 - `code: number`

74795 

74796 - `message: string`

74797 

74798 - `type: "http_error"`

74799 

74800 - `"http_error"`

74801 

74194 - `output: optional string or null`74802 - `output: optional string or null`

74195 74803 

74196 The output from the tool call.74804 The output from the tool call.


79396 for reasoning items returned by `POST /v1/responses` and WebSocket80004 for reasoning items returned by `POST /v1/responses` and WebSocket

79397 `response.create` requests.80005 `response.create` requests.

79398 80006 

80007 When streaming, use the completed reasoning item and its

80008 `encrypted_content` from the `response.output_item.done` event in

80009 subsequent requests. The `encrypted_content` in

80010 `response.output_item.added` may be incomplete. This is especially

80011 important when `store` is `false` or when using Zero Data Retention.

80012 

79399 - `status: optional "in_progress" or "completed" or "incomplete"`80013 - `status: optional "in_progress" or "completed" or "incomplete"`

79400 80014 

79401 The status of the item. One of `in_progress`, `completed`, or80015 The status of the item. One of `in_progress`, `completed`, or


80065 Unique identifier for the MCP tool call approval request.80679 Unique identifier for the MCP tool call approval request.

80066 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.80680 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

80067 80681 

80068 - `error: optional string or null`80682 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

80683 

80684 The error from the tool call, if any.

80685 

80686 - `string`

80069 80687 

80070 The error from the tool call, if any.80688 The error from the tool call, if any.

80071 80689 

80690 - `McpProtocolError object { code, message, type }`

80691 

80692 - `code: number`

80693 

80694 - `message: string`

80695 

80696 - `type: "mcp_protocol_error"`

80697 

80698 - `"mcp_protocol_error"`

80699 

80700 - `McpToolExecutionError object { content, type }`

80701 

80702 - `content: unknown`

80703 

80704 - `type: "mcp_tool_execution_error"`

80705 

80706 - `"mcp_tool_execution_error"`

80707 

80708 - `HTTPError object { code, message, type }`

80709 

80710 - `code: number`

80711 

80712 - `message: string`

80713 

80714 - `type: "http_error"`

80715 

80716 - `"http_error"`

80717 

80072 - `output: optional string or null`80718 - `output: optional string or null`

80073 80719 

80074 The output from the tool call.80720 The output from the tool call.


80999 for reasoning items returned by `POST /v1/responses` and WebSocket81645 for reasoning items returned by `POST /v1/responses` and WebSocket

81000 `response.create` requests.81646 `response.create` requests.

81001 81647 

81648 When streaming, use the completed reasoning item and its

81649 `encrypted_content` from the `response.output_item.done` event in

81650 subsequent requests. The `encrypted_content` in

81651 `response.output_item.added` may be incomplete. This is especially

81652 important when `store` is `false` or when using Zero Data Retention.

81653 

81002 - `status: optional "in_progress" or "completed" or "incomplete"`81654 - `status: optional "in_progress" or "completed" or "incomplete"`

81003 81655 

81004 The status of the item. One of `in_progress`, `completed`, or81656 The status of the item. One of `in_progress`, `completed`, or


83396 Unique identifier for the MCP tool call approval request.84048 Unique identifier for the MCP tool call approval request.

83397 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.84049 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

83398 84050 

83399 - `error: optional string or null`84051 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

84052 

84053 The error from the tool call, if any.

84054 

84055 - `string`

83400 84056 

83401 The error from the tool call, if any.84057 The error from the tool call, if any.

83402 84058 

84059 - `McpProtocolError object { code, message, type }`

84060 

84061 - `code: number`

84062 

84063 - `message: string`

84064 

84065 - `type: "mcp_protocol_error"`

84066 

84067 - `"mcp_protocol_error"`

84068 

84069 - `McpToolExecutionError object { content, type }`

84070 

84071 - `content: unknown`

84072 

84073 - `type: "mcp_tool_execution_error"`

84074 

84075 - `"mcp_tool_execution_error"`

84076 

84077 - `HTTPError object { code, message, type }`

84078 

84079 - `code: number`

84080 

84081 - `message: string`

84082 

84083 - `type: "http_error"`

84084 

84085 - `"http_error"`

84086 

83403 - `output: optional string or null`84087 - `output: optional string or null`

83404 84088 

83405 The output from the tool call.84089 The output from the tool call.


88854 for reasoning items returned by `POST /v1/responses` and WebSocket89538 for reasoning items returned by `POST /v1/responses` and WebSocket

88855 `response.create` requests.89539 `response.create` requests.

88856 89540 

89541 When streaming, use the completed reasoning item and its

89542 `encrypted_content` from the `response.output_item.done` event in

89543 subsequent requests. The `encrypted_content` in

89544 `response.output_item.added` may be incomplete. This is especially

89545 important when `store` is `false` or when using Zero Data Retention.

89546 

88857 - `status: optional "in_progress" or "completed" or "incomplete"`89547 - `status: optional "in_progress" or "completed" or "incomplete"`

88858 89548 

88859 The status of the item. One of `in_progress`, `completed`, or89549 The status of the item. One of `in_progress`, `completed`, or


89523 Unique identifier for the MCP tool call approval request.90213 Unique identifier for the MCP tool call approval request.

89524 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.90214 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

89525 90215 

89526 - `error: optional string or null`90216 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

89527 90217 

89528 The error from the tool call, if any.90218 The error from the tool call, if any.

89529 90219 

90220 - `string`

90221 

90222 The error from the tool call, if any.

90223 

90224 - `McpProtocolError object { code, message, type }`

90225 

90226 - `code: number`

90227 

90228 - `message: string`

90229 

90230 - `type: "mcp_protocol_error"`

90231 

90232 - `"mcp_protocol_error"`

90233 

90234 - `McpToolExecutionError object { content, type }`

90235 

90236 - `content: unknown`

90237 

90238 - `type: "mcp_tool_execution_error"`

90239 

90240 - `"mcp_tool_execution_error"`

90241 

90242 - `HTTPError object { code, message, type }`

90243 

90244 - `code: number`

90245 

90246 - `message: string`

90247 

90248 - `type: "http_error"`

90249 

90250 - `"http_error"`

90251 

89530 - `output: optional string or null`90252 - `output: optional string or null`

89531 90253 

89532 The output from the tool call.90254 The output from the tool call.


90457 for reasoning items returned by `POST /v1/responses` and WebSocket91179 for reasoning items returned by `POST /v1/responses` and WebSocket

90458 `response.create` requests.91180 `response.create` requests.

90459 91181 

91182 When streaming, use the completed reasoning item and its

91183 `encrypted_content` from the `response.output_item.done` event in

91184 subsequent requests. The `encrypted_content` in

91185 `response.output_item.added` may be incomplete. This is especially

91186 important when `store` is `false` or when using Zero Data Retention.

91187 

90460 - `status: optional "in_progress" or "completed" or "incomplete"`91188 - `status: optional "in_progress" or "completed" or "incomplete"`

90461 91189 

90462 The status of the item. One of `in_progress`, `completed`, or91190 The status of the item. One of `in_progress`, `completed`, or


92854 Unique identifier for the MCP tool call approval request.93582 Unique identifier for the MCP tool call approval request.

92855 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.93583 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

92856 93584 

92857 - `error: optional string or null`93585 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

93586 

93587 The error from the tool call, if any.

93588 

93589 - `string`

92858 93590 

92859 The error from the tool call, if any.93591 The error from the tool call, if any.

92860 93592 

93593 - `McpProtocolError object { code, message, type }`

93594 

93595 - `code: number`

93596 

93597 - `message: string`

93598 

93599 - `type: "mcp_protocol_error"`

93600 

93601 - `"mcp_protocol_error"`

93602 

93603 - `McpToolExecutionError object { content, type }`

93604 

93605 - `content: unknown`

93606 

93607 - `type: "mcp_tool_execution_error"`

93608 

93609 - `"mcp_tool_execution_error"`

93610 

93611 - `HTTPError object { code, message, type }`

93612 

93613 - `code: number`

93614 

93615 - `message: string`

93616 

93617 - `type: "http_error"`

93618 

93619 - `"http_error"`

93620 

92861 - `output: optional string or null`93621 - `output: optional string or null`

92862 93622 

92863 The output from the tool call.93623 The output from the tool call.


97956 for reasoning items returned by `POST /v1/responses` and WebSocket98716 for reasoning items returned by `POST /v1/responses` and WebSocket

97957 `response.create` requests.98717 `response.create` requests.

97958 98718 

98719 When streaming, use the completed reasoning item and its

98720 `encrypted_content` from the `response.output_item.done` event in

98721 subsequent requests. The `encrypted_content` in

98722 `response.output_item.added` may be incomplete. This is especially

98723 important when `store` is `false` or when using Zero Data Retention.

98724 

97959 - `status: optional "in_progress" or "completed" or "incomplete"`98725 - `status: optional "in_progress" or "completed" or "incomplete"`

97960 98726 

97961 The status of the item. One of `in_progress`, `completed`, or98727 The status of the item. One of `in_progress`, `completed`, or


98625 Unique identifier for the MCP tool call approval request.99391 Unique identifier for the MCP tool call approval request.

98626 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.99392 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

98627 99393 

98628 - `error: optional string or null`99394 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

99395 

99396 The error from the tool call, if any.

99397 

99398 - `string`

98629 99399 

98630 The error from the tool call, if any.99400 The error from the tool call, if any.

98631 99401 

99402 - `McpProtocolError object { code, message, type }`

99403 

99404 - `code: number`

99405 

99406 - `message: string`

99407 

99408 - `type: "mcp_protocol_error"`

99409 

99410 - `"mcp_protocol_error"`

99411 

99412 - `McpToolExecutionError object { content, type }`

99413 

99414 - `content: unknown`

99415 

99416 - `type: "mcp_tool_execution_error"`

99417 

99418 - `"mcp_tool_execution_error"`

99419 

99420 - `HTTPError object { code, message, type }`

99421 

99422 - `code: number`

99423 

99424 - `message: string`

99425 

99426 - `type: "http_error"`

99427 

99428 - `"http_error"`

99429 

98632 - `output: optional string or null`99430 - `output: optional string or null`

98633 99431 

98634 The output from the tool call.99432 The output from the tool call.


99559 for reasoning items returned by `POST /v1/responses` and WebSocket100357 for reasoning items returned by `POST /v1/responses` and WebSocket

99560 `response.create` requests.100358 `response.create` requests.

99561 100359 

100360 When streaming, use the completed reasoning item and its

100361 `encrypted_content` from the `response.output_item.done` event in

100362 subsequent requests. The `encrypted_content` in

100363 `response.output_item.added` may be incomplete. This is especially

100364 important when `store` is `false` or when using Zero Data Retention.

100365 

99562 - `status: optional "in_progress" or "completed" or "incomplete"`100366 - `status: optional "in_progress" or "completed" or "incomplete"`

99563 100367 

99564 The status of the item. One of `in_progress`, `completed`, or100368 The status of the item. One of `in_progress`, `completed`, or


101956 Unique identifier for the MCP tool call approval request.102760 Unique identifier for the MCP tool call approval request.

101957 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.102761 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

101958 102762 

101959 - `error: optional string or null`102763 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

101960 102764 

101961 The error from the tool call, if any.102765 The error from the tool call, if any.

101962 102766 

102767 - `string`

102768 

102769 The error from the tool call, if any.

102770 

102771 - `McpProtocolError object { code, message, type }`

102772 

102773 - `code: number`

102774 

102775 - `message: string`

102776 

102777 - `type: "mcp_protocol_error"`

102778 

102779 - `"mcp_protocol_error"`

102780 

102781 - `McpToolExecutionError object { content, type }`

102782 

102783 - `content: unknown`

102784 

102785 - `type: "mcp_tool_execution_error"`

102786 

102787 - `"mcp_tool_execution_error"`

102788 

102789 - `HTTPError object { code, message, type }`

102790 

102791 - `code: number`

102792 

102793 - `message: string`

102794 

102795 - `type: "http_error"`

102796 

102797 - `"http_error"`

102798 

101963 - `output: optional string or null`102799 - `output: optional string or null`

101964 102800 

101965 The output from the tool call.102801 The output from the tool call.


105645 for reasoning items returned by `POST /v1/responses` and WebSocket106481 for reasoning items returned by `POST /v1/responses` and WebSocket

105646 `response.create` requests.106482 `response.create` requests.

105647 106483 

106484 When streaming, use the completed reasoning item and its

106485 `encrypted_content` from the `response.output_item.done` event in

106486 subsequent requests. The `encrypted_content` in

106487 `response.output_item.added` may be incomplete. This is especially

106488 important when `store` is `false` or when using Zero Data Retention.

106489 

105648 - `status: optional "in_progress" or "completed" or "incomplete"`106490 - `status: optional "in_progress" or "completed" or "incomplete"`

105649 106491 

105650 The status of the item. One of `in_progress`, `completed`, or106492 The status of the item. One of `in_progress`, `completed`, or


108291 Unique identifier for the MCP tool call approval request.109133 Unique identifier for the MCP tool call approval request.

108292 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.109134 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

108293 109135 

108294 - `error: optional string or null`109136 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

109137 

109138 The error from the tool call, if any.

109139 

109140 - `string`

108295 109141 

108296 The error from the tool call, if any.109142 The error from the tool call, if any.

108297 109143 

109144 - `McpProtocolError object { code, message, type }`

109145 

109146 - `code: number`

109147 

109148 - `message: string`

109149 

109150 - `type: "mcp_protocol_error"`

109151 

109152 - `"mcp_protocol_error"`

109153 

109154 - `McpToolExecutionError object { content, type }`

109155 

109156 - `content: unknown`

109157 

109158 - `type: "mcp_tool_execution_error"`

109159 

109160 - `"mcp_tool_execution_error"`

109161 

109162 - `HTTPError object { code, message, type }`

109163 

109164 - `code: number`

109165 

109166 - `message: string`

109167 

109168 - `type: "http_error"`

109169 

109170 - `"http_error"`

109171 

108298 - `output: optional string or null`109172 - `output: optional string or null`

108299 109173 

108300 The output from the tool call.109174 The output from the tool call.


108545 109419 

108546 - `item: ResponseOutputItem`109420 - `item: ResponseOutputItem`

108547 109421 

108548 The output item that was added.109422 The output item that was added. For reasoning items, `encrypted_content`

109423 may be incomplete while the item is in progress. Use the reasoning item

109424 from the corresponding `response.output_item.done` event when passing it

109425 as input to a subsequent request.

108549 109426 

108550 - `ResponseOutputMessage object { id, content, role, 3 more }`109427 - `ResponseOutputMessage object { id, content, role, 3 more }`

108551 109428 


109550 for reasoning items returned by `POST /v1/responses` and WebSocket110427 for reasoning items returned by `POST /v1/responses` and WebSocket

109551 `response.create` requests.110428 `response.create` requests.

109552 110429 

110430 When streaming, use the completed reasoning item and its

110431 `encrypted_content` from the `response.output_item.done` event in

110432 subsequent requests. The `encrypted_content` in

110433 `response.output_item.added` may be incomplete. This is especially

110434 important when `store` is `false` or when using Zero Data Retention.

110435 

109553 - `status: optional "in_progress" or "completed" or "incomplete"`110436 - `status: optional "in_progress" or "completed" or "incomplete"`

109554 110437 

109555 The status of the item. One of `in_progress`, `completed`, or110438 The status of the item. One of `in_progress`, `completed`, or


112196 Unique identifier for the MCP tool call approval request.113079 Unique identifier for the MCP tool call approval request.

112197 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.113080 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

112198 113081 

112199 - `error: optional string or null`113082 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

113083 

113084 The error from the tool call, if any.

113085 

113086 - `string`

112200 113087 

112201 The error from the tool call, if any.113088 The error from the tool call, if any.

112202 113089 

113090 - `McpProtocolError object { code, message, type }`

113091 

113092 - `code: number`

113093 

113094 - `message: string`

113095 

113096 - `type: "mcp_protocol_error"`

113097 

113098 - `"mcp_protocol_error"`

113099 

113100 - `McpToolExecutionError object { content, type }`

113101 

113102 - `content: unknown`

113103 

113104 - `type: "mcp_tool_execution_error"`

113105 

113106 - `"mcp_tool_execution_error"`

113107 

113108 - `HTTPError object { code, message, type }`

113109 

113110 - `code: number`

113111 

113112 - `message: string`

113113 

113114 - `type: "http_error"`

113115 

113116 - `"http_error"`

113117 

112203 - `output: optional string or null`113118 - `output: optional string or null`

112204 113119 

112205 The output from the tool call.113120 The output from the tool call.


113469 for reasoning items returned by `POST /v1/responses` and WebSocket114384 for reasoning items returned by `POST /v1/responses` and WebSocket

113470 `response.create` requests.114385 `response.create` requests.

113471 114386 

114387 When streaming, use the completed reasoning item and its

114388 `encrypted_content` from the `response.output_item.done` event in

114389 subsequent requests. The `encrypted_content` in

114390 `response.output_item.added` may be incomplete. This is especially

114391 important when `store` is `false` or when using Zero Data Retention.

114392 

113472 - `status: optional "in_progress" or "completed" or "incomplete"`114393 - `status: optional "in_progress" or "completed" or "incomplete"`

113473 114394 

113474 The status of the item. One of `in_progress`, `completed`, or114395 The status of the item. One of `in_progress`, `completed`, or


116115 Unique identifier for the MCP tool call approval request.117036 Unique identifier for the MCP tool call approval request.

116116 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.117037 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

116117 117038 

116118 - `error: optional string or null`117039 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

116119 117040 

116120 The error from the tool call, if any.117041 The error from the tool call, if any.

116121 117042 

117043 - `string`

117044 

117045 The error from the tool call, if any.

117046 

117047 - `McpProtocolError object { code, message, type }`

117048 

117049 - `code: number`

117050 

117051 - `message: string`

117052 

117053 - `type: "mcp_protocol_error"`

117054 

117055 - `"mcp_protocol_error"`

117056 

117057 - `McpToolExecutionError object { content, type }`

117058 

117059 - `content: unknown`

117060 

117061 - `type: "mcp_tool_execution_error"`

117062 

117063 - `"mcp_tool_execution_error"`

117064 

117065 - `HTTPError object { code, message, type }`

117066 

117067 - `code: number`

117068 

117069 - `message: string`

117070 

117071 - `type: "http_error"`

117072 

117073 - `"http_error"`

117074 

116122 - `output: optional string or null`117075 - `output: optional string or null`

116123 117076 

116124 The output from the tool call.117077 The output from the tool call.


116720 117673 

116721 Emitted when an annotation is added to output text content.117674 Emitted when an annotation is added to output text content.

116722 117675 

116723 - `annotation: unknown`117676 - `annotation: object { file_id, filename, index, type } or object { end_index, start_index, title, 2 more } or object { container_id, end_index, file_id, 3 more } or object { file_id, index, type } or null`

117677 

117678 An annotation that applies to a span of output text.

117679 

117680 - `FileCitation object { file_id, filename, index, type }`

117681 

117682 A citation to a file.

117683 

117684 - `file_id: string`

117685 

117686 The ID of the file.

117687 

117688 - `filename: string`

117689 

117690 The filename of the file cited.

117691 

117692 - `index: number`

117693 

117694 The index of the file in the list of files.

117695 

117696 - `type: "file_citation"`

117697 

117698 The type of the file citation. Always `file_citation`.

117699 

117700 - `"file_citation"`

117701 

117702 - `URLCitation object { end_index, start_index, title, 2 more }`

117703 

117704 A citation for a web resource used to generate a model response.

117705 

117706 - `end_index: number`

117707 

117708 The index of the last character of the URL citation in the message.

117709 

117710 - `start_index: number`

117711 

117712 The index of the first character of the URL citation in the message.

117713 

117714 - `title: string`

117715 

117716 The title of the web resource.

117717 

117718 - `type: "url_citation"`

117719 

117720 The type of the URL citation. Always `url_citation`.

117721 

117722 - `"url_citation"`

117723 

117724 - `url: string`

117725 

117726 The URL of the web resource.

117727 

117728 - `ContainerFileCitation object { container_id, end_index, file_id, 3 more }`

117729 

117730 A citation for a container file used to generate a model response.

117731 

117732 - `container_id: string`

117733 

117734 The ID of the container file.

117735 

117736 - `end_index: number`

116724 117737 

116725 The annotation object being added. (See annotation schema for details.)117738 The index of the last character of the container file citation in the message.

117739 

117740 - `file_id: string`

117741 

117742 The ID of the file.

117743 

117744 - `filename: string`

117745 

117746 The filename of the container file cited.

117747 

117748 - `start_index: number`

117749 

117750 The index of the first character of the container file citation in the message.

117751 

117752 - `type: "container_file_citation"`

117753 

117754 The type of the container file citation. Always `container_file_citation`.

117755 

117756 - `"container_file_citation"`

117757 

117758 - `FilePath object { file_id, index, type }`

117759 

117760 A path to a file.

117761 

117762 - `file_id: string`

117763 

117764 The ID of the file.

117765 

117766 - `index: number`

117767 

117768 The index of the file in the list of files.

117769 

117770 - `type: "file_path"`

117771 

117772 The type of the file path. Always `file_path`.

117773 

117774 - `"file_path"`

116726 117775 

116727 - `annotation_index: number`117776 - `annotation_index: number`

116728 117777 


120148 for reasoning items returned by `POST /v1/responses` and WebSocket121197 for reasoning items returned by `POST /v1/responses` and WebSocket

120149 `response.create` requests.121198 `response.create` requests.

120150 121199 

121200 When streaming, use the completed reasoning item and its

121201 `encrypted_content` from the `response.output_item.done` event in

121202 subsequent requests. The `encrypted_content` in

121203 `response.output_item.added` may be incomplete. This is especially

121204 important when `store` is `false` or when using Zero Data Retention.

121205 

120151 - `status: optional "in_progress" or "completed" or "incomplete"`121206 - `status: optional "in_progress" or "completed" or "incomplete"`

120152 121207 

120153 The status of the item. One of `in_progress`, `completed`, or121208 The status of the item. One of `in_progress`, `completed`, or


120817 Unique identifier for the MCP tool call approval request.121872 Unique identifier for the MCP tool call approval request.

120818 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.121873 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

120819 121874 

120820 - `error: optional string or null`121875 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

120821 121876 

120822 The error from the tool call, if any.121877 The error from the tool call, if any.

120823 121878 

121879 - `string`

121880 

121881 The error from the tool call, if any.

121882 

121883 - `McpProtocolError object { code, message, type }`

121884 

121885 - `code: number`

121886 

121887 - `message: string`

121888 

121889 - `type: "mcp_protocol_error"`

121890 

121891 - `"mcp_protocol_error"`

121892 

121893 - `McpToolExecutionError object { content, type }`

121894 

121895 - `content: unknown`

121896 

121897 - `type: "mcp_tool_execution_error"`

121898 

121899 - `"mcp_tool_execution_error"`

121900 

121901 - `HTTPError object { code, message, type }`

121902 

121903 - `code: number`

121904 

121905 - `message: string`

121906 

121907 - `type: "http_error"`

121908 

121909 - `"http_error"`

121910 

120824 - `output: optional string or null`121911 - `output: optional string or null`

120825 121912 

120826 The output from the tool call.121913 The output from the tool call.


121751 for reasoning items returned by `POST /v1/responses` and WebSocket122838 for reasoning items returned by `POST /v1/responses` and WebSocket

121752 `response.create` requests.122839 `response.create` requests.

121753 122840 

122841 When streaming, use the completed reasoning item and its

122842 `encrypted_content` from the `response.output_item.done` event in

122843 subsequent requests. The `encrypted_content` in

122844 `response.output_item.added` may be incomplete. This is especially

122845 important when `store` is `false` or when using Zero Data Retention.

122846 

121754 - `status: optional "in_progress" or "completed" or "incomplete"`122847 - `status: optional "in_progress" or "completed" or "incomplete"`

121755 122848 

121756 The status of the item. One of `in_progress`, `completed`, or122849 The status of the item. One of `in_progress`, `completed`, or


124148 Unique identifier for the MCP tool call approval request.125241 Unique identifier for the MCP tool call approval request.

124149 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.125242 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

124150 125243 

124151 - `error: optional string or null`125244 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

124152 125245 

124153 The error from the tool call, if any.125246 The error from the tool call, if any.

124154 125247 

125248 - `string`

125249 

125250 The error from the tool call, if any.

125251 

125252 - `McpProtocolError object { code, message, type }`

125253 

125254 - `code: number`

125255 

125256 - `message: string`

125257 

125258 - `type: "mcp_protocol_error"`

125259 

125260 - `"mcp_protocol_error"`

125261 

125262 - `McpToolExecutionError object { content, type }`

125263 

125264 - `content: unknown`

125265 

125266 - `type: "mcp_tool_execution_error"`

125267 

125268 - `"mcp_tool_execution_error"`

125269 

125270 - `HTTPError object { code, message, type }`

125271 

125272 - `code: number`

125273 

125274 - `message: string`

125275 

125276 - `type: "http_error"`

125277 

125278 - `"http_error"`

125279 

124155 - `output: optional string or null`125280 - `output: optional string or null`

124156 125281 

124157 The output from the tool call.125282 The output from the tool call.


129707 for reasoning items returned by `POST /v1/responses` and WebSocket130832 for reasoning items returned by `POST /v1/responses` and WebSocket

129708 `response.create` requests.130833 `response.create` requests.

129709 130834 

130835 When streaming, use the completed reasoning item and its

130836 `encrypted_content` from the `response.output_item.done` event in

130837 subsequent requests. The `encrypted_content` in

130838 `response.output_item.added` may be incomplete. This is especially

130839 important when `store` is `false` or when using Zero Data Retention.

130840 

129710 - `status: optional "in_progress" or "completed" or "incomplete"`130841 - `status: optional "in_progress" or "completed" or "incomplete"`

129711 130842 

129712 The status of the item. One of `in_progress`, `completed`, or130843 The status of the item. One of `in_progress`, `completed`, or


130376 Unique identifier for the MCP tool call approval request.131507 Unique identifier for the MCP tool call approval request.

130377 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.131508 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

130378 131509 

130379 - `error: optional string or null`131510 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

130380 131511 

130381 The error from the tool call, if any.131512 The error from the tool call, if any.

130382 131513 

131514 - `string`

131515 

131516 The error from the tool call, if any.

131517 

131518 - `McpProtocolError object { code, message, type }`

131519 

131520 - `code: number`

131521 

131522 - `message: string`

131523 

131524 - `type: "mcp_protocol_error"`

131525 

131526 - `"mcp_protocol_error"`

131527 

131528 - `McpToolExecutionError object { content, type }`

131529 

131530 - `content: unknown`

131531 

131532 - `type: "mcp_tool_execution_error"`

131533 

131534 - `"mcp_tool_execution_error"`

131535 

131536 - `HTTPError object { code, message, type }`

131537 

131538 - `code: number`

131539 

131540 - `message: string`

131541 

131542 - `type: "http_error"`

131543 

131544 - `"http_error"`

131545 

130383 - `output: optional string or null`131546 - `output: optional string or null`

130384 131547 

130385 The output from the tool call.131548 The output from the tool call.


131310 for reasoning items returned by `POST /v1/responses` and WebSocket132473 for reasoning items returned by `POST /v1/responses` and WebSocket

131311 `response.create` requests.132474 `response.create` requests.

131312 132475 

132476 When streaming, use the completed reasoning item and its

132477 `encrypted_content` from the `response.output_item.done` event in

132478 subsequent requests. The `encrypted_content` in

132479 `response.output_item.added` may be incomplete. This is especially

132480 important when `store` is `false` or when using Zero Data Retention.

132481 

131313 - `status: optional "in_progress" or "completed" or "incomplete"`132482 - `status: optional "in_progress" or "completed" or "incomplete"`

131314 132483 

131315 The status of the item. One of `in_progress`, `completed`, or132484 The status of the item. One of `in_progress`, `completed`, or


133707 Unique identifier for the MCP tool call approval request.134876 Unique identifier for the MCP tool call approval request.

133708 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.134877 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

133709 134878 

133710 - `error: optional string or null`134879 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

133711 134880 

133712 The error from the tool call, if any.134881 The error from the tool call, if any.

133713 134882 

134883 - `string`

134884 

134885 The error from the tool call, if any.

134886 

134887 - `McpProtocolError object { code, message, type }`

134888 

134889 - `code: number`

134890 

134891 - `message: string`

134892 

134893 - `type: "mcp_protocol_error"`

134894 

134895 - `"mcp_protocol_error"`

134896 

134897 - `McpToolExecutionError object { content, type }`

134898 

134899 - `content: unknown`

134900 

134901 - `type: "mcp_tool_execution_error"`

134902 

134903 - `"mcp_tool_execution_error"`

134904 

134905 - `HTTPError object { code, message, type }`

134906 

134907 - `code: number`

134908 

134909 - `message: string`

134910 

134911 - `type: "http_error"`

134912 

134913 - `"http_error"`

134914 

133714 - `output: optional string or null`134915 - `output: optional string or null`

133715 134916 

133716 The output from the tool call.134917 The output from the tool call.


135841 137042 

135842 - `item: ResponseOutputItem`137043 - `item: ResponseOutputItem`

135843 137044 

135844 The output item that was added.137045 The output item that was added. For reasoning items, `encrypted_content`

137046 may be incomplete while the item is in progress. Use the reasoning item

137047 from the corresponding `response.output_item.done` event when passing it

137048 as input to a subsequent request.

135845 137049 

135846 - `ResponseOutputMessage object { id, content, role, 3 more }`137050 - `ResponseOutputMessage object { id, content, role, 3 more }`

135847 137051 


136707 137911 

136708 Emitted when an annotation is added to output text content.137912 Emitted when an annotation is added to output text content.

136709 137913 

136710 - `annotation: unknown`137914 - `annotation: object { file_id, filename, index, type } or object { end_index, start_index, title, 2 more } or object { container_id, end_index, file_id, 3 more } or object { file_id, index, type } or null`

137915 

137916 An annotation that applies to a span of output text.

137917 

137918 - `FileCitation object { file_id, filename, index, type }`

137919 

137920 A citation to a file.

137921 

137922 - `file_id: string`

137923 

137924 The ID of the file.

137925 

137926 - `filename: string`

137927 

137928 The filename of the file cited.

137929 

137930 - `index: number`

137931 

137932 The index of the file in the list of files.

137933 

137934 - `type: "file_citation"`

137935 

137936 The type of the file citation. Always `file_citation`.

137937 

137938 - `"file_citation"`

137939 

137940 - `URLCitation object { end_index, start_index, title, 2 more }`

137941 

137942 A citation for a web resource used to generate a model response.

137943 

137944 - `end_index: number`

137945 

137946 The index of the last character of the URL citation in the message.

137947 

137948 - `start_index: number`

137949 

137950 The index of the first character of the URL citation in the message.

137951 

137952 - `title: string`

137953 

137954 The title of the web resource.

137955 

137956 - `type: "url_citation"`

137957 

137958 The type of the URL citation. Always `url_citation`.

137959 

137960 - `"url_citation"`

137961 

137962 - `url: string`

137963 

137964 The URL of the web resource.

137965 

137966 - `ContainerFileCitation object { container_id, end_index, file_id, 3 more }`

137967 

137968 A citation for a container file used to generate a model response.

137969 

137970 - `container_id: string`

137971 

137972 The ID of the container file.

137973 

137974 - `end_index: number`

137975 

137976 The index of the last character of the container file citation in the message.

137977 

137978 - `file_id: string`

137979 

137980 The ID of the file.

137981 

137982 - `filename: string`

137983 

137984 The filename of the container file cited.

137985 

137986 - `start_index: number`

137987 

137988 The index of the first character of the container file citation in the message.

137989 

137990 - `type: "container_file_citation"`

137991 

137992 The type of the container file citation. Always `container_file_citation`.

137993 

137994 - `"container_file_citation"`

137995 

137996 - `FilePath object { file_id, index, type }`

137997 

137998 A path to a file.

137999 

138000 - `file_id: string`

138001 

138002 The ID of the file.

138003 

138004 - `index: number`

138005 

138006 The index of the file in the list of files.

138007 

138008 - `type: "file_path"`

136711 138009 

136712 The annotation object being added. (See annotation schema for details.)138010 The type of the file path. Always `file_path`.

138011 

138012 - `"file_path"`

136713 138013 

136714 - `annotation_index: number`138014 - `annotation_index: number`

136715 138015 


140386 for reasoning items returned by `POST /v1/responses` and WebSocket141686 for reasoning items returned by `POST /v1/responses` and WebSocket

140387 `response.create` requests.141687 `response.create` requests.

140388 141688 

141689 When streaming, use the completed reasoning item and its

141690 `encrypted_content` from the `response.output_item.done` event in

141691 subsequent requests. The `encrypted_content` in

141692 `response.output_item.added` may be incomplete. This is especially

141693 important when `store` is `false` or when using Zero Data Retention.

141694 

140389 - `status: optional "in_progress" or "completed" or "incomplete"`141695 - `status: optional "in_progress" or "completed" or "incomplete"`

140390 141696 

140391 The status of the item. One of `in_progress`, `completed`, or141697 The status of the item. One of `in_progress`, `completed`, or


141055 Unique identifier for the MCP tool call approval request.142361 Unique identifier for the MCP tool call approval request.

141056 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.142362 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

141057 142363 

141058 - `error: optional string or null`142364 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

141059 142365 

141060 The error from the tool call, if any.142366 The error from the tool call, if any.

141061 142367 

142368 - `string`

142369 

142370 The error from the tool call, if any.

142371 

142372 - `McpProtocolError object { code, message, type }`

142373 

142374 - `code: number`

142375 

142376 - `message: string`

142377 

142378 - `type: "mcp_protocol_error"`

142379 

142380 - `"mcp_protocol_error"`

142381 

142382 - `McpToolExecutionError object { content, type }`

142383 

142384 - `content: unknown`

142385 

142386 - `type: "mcp_tool_execution_error"`

142387 

142388 - `"mcp_tool_execution_error"`

142389 

142390 - `HTTPError object { code, message, type }`

142391 

142392 - `code: number`

142393 

142394 - `message: string`

142395 

142396 - `type: "http_error"`

142397 

142398 - `"http_error"`

142399 

141062 - `output: optional string or null`142400 - `output: optional string or null`

141063 142401 

141064 The output from the tool call.142402 The output from the tool call.


143063 when the originating `response.create` event supplied a144401 when the originating `response.create` event supplied a

143064 `stream_id`.144402 `stream_id`.

143065 144403 

143066 - `ResponseWsError = ResponseErrorEvent`

143067 

143068 Emitted when an error occurs.

143069 

143070 - `stream_id: optional string`

143071 

143072 The WebSocket lane that emitted this event. This field is present

143073 when the originating `response.create` event supplied a

143074 `stream_id`.

143075 

143076 - `ResponseFileSearchCallWsCompleted = ResponseFileSearchCallCompletedEvent`144404 - `ResponseFileSearchCallWsCompleted = ResponseFileSearchCallCompletedEvent`

143077 144405 

143078 Emitted when a file search call is completed (results found).144406 Emitted when a file search call is completed (results found).


143463 when the originating `response.create` event supplied a144791 when the originating `response.create` event supplied a

143464 `stream_id`.144792 `stream_id`.

143465 144793 

144794 - `ResponseWsError object { error, type, sequence_number, 2 more }`

144795 

144796 Emitted when an error occurs while processing a Responses WebSocket request.

144797 

144798 - `error: object { code, message, param, 2 more }`

144799 

144800 Details about the error.

144801 

144802 - `code: string or null`

144803 

144804 The error code that was emitted, if any.

144805 

144806 - `message: string`

144807 

144808 The human-readable error message that was emitted.

144809 

144810 - `param: string or null`

144811 

144812 The parameter name that was associated with the error, if any.

144813 

144814 - `type: string`

144815 

144816 The error type that was emitted.

144817 

144818 - `headers: optional map[string]`

144819 

144820 The response headers that were emitted with the error, if any.

144821 

144822 - `type: "error"`

144823 

144824 The type of the event. Always `error`.

144825 

144826 - `"error"`

144827 

144828 - `sequence_number: optional number`

144829 

144830 The sequence number of an error emitted by the response stream.

144831 

144832 - `status: optional number`

144833 

144834 The HTTP status code associated with a WebSocket protocol error.

144835 

144836 - `stream_id: optional string`

144837 

144838 The WebSocket lane that emitted this event. This field is present when the

144839 originating `response.create` event supplied a `stream_id`.

144840 

143466### Skill Reference144841### Skill Reference

143467 144842 

143468- `SkillReference object { skill_id, type, version }`144843- `SkillReference object { skill_id, type, version }`


146767 for reasoning items returned by `POST /v1/responses` and WebSocket148142 for reasoning items returned by `POST /v1/responses` and WebSocket

146768 `response.create` requests.148143 `response.create` requests.

146769 148144 

148145 When streaming, use the completed reasoning item and its

148146 `encrypted_content` from the `response.output_item.done` event in

148147 subsequent requests. The `encrypted_content` in

148148 `response.output_item.added` may be incomplete. This is especially

148149 important when `store` is `false` or when using Zero Data Retention.

148150 

146770 - `status: optional "in_progress" or "completed" or "incomplete"`148151 - `status: optional "in_progress" or "completed" or "incomplete"`

146771 148152 

146772 The status of the item. One of `in_progress`, `completed`, or148153 The status of the item. One of `in_progress`, `completed`, or


147512 Unique identifier for the MCP tool call approval request.148893 Unique identifier for the MCP tool call approval request.

147513 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.148894 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

147514 148895 

147515 - `error: optional string or null`148896 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

147516 148897 

147517 The error from the tool call, if any.148898 The error from the tool call, if any.

147518 148899 

148900 - `string`

148901 

148902 The error from the tool call, if any.

148903 

148904 - `McpProtocolError object { code, message, type }`

148905 

148906 - `code: number`

148907 

148908 - `message: string`

148909 

148910 - `type: "mcp_protocol_error"`

148911 

148912 - `"mcp_protocol_error"`

148913 

148914 - `McpToolExecutionError object { content, type }`

148915 

148916 - `content: unknown`

148917 

148918 - `type: "mcp_tool_execution_error"`

148919 

148920 - `"mcp_tool_execution_error"`

148921 

148922 - `HTTPError object { code, message, type }`

148923 

148924 - `code: number`

148925 

148926 - `message: string`

148927 

148928 - `type: "http_error"`

148929 

148930 - `"http_error"`

148931 

147519 - `output: optional string or null`148932 - `output: optional string or null`

147520 148933 

147521 The output from the tool call.148934 The output from the tool call.


150823 for reasoning items returned by `POST /v1/responses` and WebSocket152236 for reasoning items returned by `POST /v1/responses` and WebSocket

150824 `response.create` requests.152237 `response.create` requests.

150825 152238 

152239 When streaming, use the completed reasoning item and its

152240 `encrypted_content` from the `response.output_item.done` event in

152241 subsequent requests. The `encrypted_content` in

152242 `response.output_item.added` may be incomplete. This is especially

152243 important when `store` is `false` or when using Zero Data Retention.

152244 

150826 - `status: optional "in_progress" or "completed" or "incomplete"`152245 - `status: optional "in_progress" or "completed" or "incomplete"`

150827 152246 

150828 The status of the item. One of `in_progress`, `completed`, or152247 The status of the item. One of `in_progress`, `completed`, or


151568 Unique identifier for the MCP tool call approval request.152987 Unique identifier for the MCP tool call approval request.

151569 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.152988 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

151570 152989 

151571 - `error: optional string or null`152990 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

151572 152991 

151573 The error from the tool call, if any.152992 The error from the tool call, if any.

151574 152993 

152994 - `string`

152995 

152996 The error from the tool call, if any.

152997 

152998 - `McpProtocolError object { code, message, type }`

152999 

153000 - `code: number`

153001 

153002 - `message: string`

153003 

153004 - `type: "mcp_protocol_error"`

153005 

153006 - `"mcp_protocol_error"`

153007 

153008 - `McpToolExecutionError object { content, type }`

153009 

153010 - `content: unknown`

153011 

153012 - `type: "mcp_tool_execution_error"`

153013 

153014 - `"mcp_tool_execution_error"`

153015 

153016 - `HTTPError object { code, message, type }`

153017 

153018 - `code: number`

153019 

153020 - `message: string`

153021 

153022 - `type: "http_error"`

153023 

153024 - `"http_error"`

153025 

151575 - `output: optional string or null`153026 - `output: optional string or null`

151576 153027 

151577 The output from the tool call.153028 The output from the tool call.


154957 for reasoning items returned by `POST /v1/responses` and WebSocket156408 for reasoning items returned by `POST /v1/responses` and WebSocket

154958 `response.create` requests.156409 `response.create` requests.

154959 156410 

156411 When streaming, use the completed reasoning item and its

156412 `encrypted_content` from the `response.output_item.done` event in

156413 subsequent requests. The `encrypted_content` in

156414 `response.output_item.added` may be incomplete. This is especially

156415 important when `store` is `false` or when using Zero Data Retention.

156416 

154960 - `status: optional "in_progress" or "completed" or "incomplete"`156417 - `status: optional "in_progress" or "completed" or "incomplete"`

154961 156418 

154962 The status of the item. One of `in_progress`, `completed`, or156419 The status of the item. One of `in_progress`, `completed`, or


155626 Unique identifier for the MCP tool call approval request.157083 Unique identifier for the MCP tool call approval request.

155627 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.157084 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

155628 157085 

155629 - `error: optional string or null`157086 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

155630 157087 

155631 The error from the tool call, if any.157088 The error from the tool call, if any.

155632 157089 

157090 - `string`

157091 

157092 The error from the tool call, if any.

157093 

157094 - `McpProtocolError object { code, message, type }`

157095 

157096 - `code: number`

157097 

157098 - `message: string`

157099 

157100 - `type: "mcp_protocol_error"`

157101 

157102 - `"mcp_protocol_error"`

157103 

157104 - `McpToolExecutionError object { content, type }`

157105 

157106 - `content: unknown`

157107 

157108 - `type: "mcp_tool_execution_error"`

157109 

157110 - `"mcp_tool_execution_error"`

157111 

157112 - `HTTPError object { code, message, type }`

157113 

157114 - `code: number`

157115 

157116 - `message: string`

157117 

157118 - `type: "http_error"`

157119 

157120 - `"http_error"`

157121 

155633 - `output: optional string or null`157122 - `output: optional string or null`

155634 157123 

155635 The output from the tool call.157124 The output from the tool call.

Details

3269 for reasoning items returned by `POST /v1/responses` and WebSocket3269 for reasoning items returned by `POST /v1/responses` and WebSocket

3270 `response.create` requests.3270 `response.create` requests.

3271 3271 

3272 When streaming, use the completed reasoning item and its

3273 `encrypted_content` from the `response.output_item.done` event in

3274 subsequent requests. The `encrypted_content` in

3275 `response.output_item.added` may be incomplete. This is especially

3276 important when `store` is `false` or when using Zero Data Retention.

3277 

3272 - `status: optional "in_progress" or "completed" or "incomplete"`3278 - `status: optional "in_progress" or "completed" or "incomplete"`

3273 3279 

3274 The status of the item. One of `in_progress`, `completed`, or3280 The status of the item. One of `in_progress`, `completed`, or


3938 Unique identifier for the MCP tool call approval request.3944 Unique identifier for the MCP tool call approval request.

3939 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.3945 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

3940 3946 

3941 - `error: optional string or null`3947 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

3948 

3949 The error from the tool call, if any.

3950 

3951 - `string`

3942 3952 

3943 The error from the tool call, if any.3953 The error from the tool call, if any.

3944 3954 

3955 - `McpProtocolError object { code, message, type }`

3956 

3957 - `code: number`

3958 

3959 - `message: string`

3960 

3961 - `type: "mcp_protocol_error"`

3962 

3963 - `"mcp_protocol_error"`

3964 

3965 - `McpToolExecutionError object { content, type }`

3966 

3967 - `content: unknown`

3968 

3969 - `type: "mcp_tool_execution_error"`

3970 

3971 - `"mcp_tool_execution_error"`

3972 

3973 - `HTTPError object { code, message, type }`

3974 

3975 - `code: number`

3976 

3977 - `message: string`

3978 

3979 - `type: "http_error"`

3980 

3981 - `"http_error"`

3982 

3945 - `output: optional string or null`3983 - `output: optional string or null`

3946 3984 

3947 The output from the tool call.3985 The output from the tool call.


4872 for reasoning items returned by `POST /v1/responses` and WebSocket4910 for reasoning items returned by `POST /v1/responses` and WebSocket

4873 `response.create` requests.4911 `response.create` requests.

4874 4912 

4913 When streaming, use the completed reasoning item and its

4914 `encrypted_content` from the `response.output_item.done` event in

4915 subsequent requests. The `encrypted_content` in

4916 `response.output_item.added` may be incomplete. This is especially

4917 important when `store` is `false` or when using Zero Data Retention.

4918 

4875 - `status: optional "in_progress" or "completed" or "incomplete"`4919 - `status: optional "in_progress" or "completed" or "incomplete"`

4876 4920 

4877 The status of the item. One of `in_progress`, `completed`, or4921 The status of the item. One of `in_progress`, `completed`, or


7269 Unique identifier for the MCP tool call approval request.7313 Unique identifier for the MCP tool call approval request.

7270 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.7314 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

7271 7315 

7272 - `error: optional string or null`7316 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

7317 

7318 The error from the tool call, if any.

7319 

7320 - `string`

7273 7321 

7274 The error from the tool call, if any.7322 The error from the tool call, if any.

7275 7323 

7324 - `McpProtocolError object { code, message, type }`

7325 

7326 - `code: number`

7327 

7328 - `message: string`

7329 

7330 - `type: "mcp_protocol_error"`

7331 

7332 - `"mcp_protocol_error"`

7333 

7334 - `McpToolExecutionError object { content, type }`

7335 

7336 - `content: unknown`

7337 

7338 - `type: "mcp_tool_execution_error"`

7339 

7340 - `"mcp_tool_execution_error"`

7341 

7342 - `HTTPError object { code, message, type }`

7343 

7344 - `code: number`

7345 

7346 - `message: string`

7347 

7348 - `type: "http_error"`

7349 

7350 - `"http_error"`

7351 

7276 - `output: optional string or null`7352 - `output: optional string or null`

7277 7353 

7278 The output from the tool call.7354 The output from the tool call.

Details

3399 for reasoning items returned by `POST /v1/responses` and WebSocket3399 for reasoning items returned by `POST /v1/responses` and WebSocket

3400 `response.create` requests.3400 `response.create` requests.

3401 3401 

3402 When streaming, use the completed reasoning item and its

3403 `encrypted_content` from the `response.output_item.done` event in

3404 subsequent requests. The `encrypted_content` in

3405 `response.output_item.added` may be incomplete. This is especially

3406 important when `store` is `false` or when using Zero Data Retention.

3407 

3402 - `status: optional "in_progress" or "completed" or "incomplete"`3408 - `status: optional "in_progress" or "completed" or "incomplete"`

3403 3409 

3404 The status of the item. One of `in_progress`, `completed`, or3410 The status of the item. One of `in_progress`, `completed`, or


4068 Unique identifier for the MCP tool call approval request.4074 Unique identifier for the MCP tool call approval request.

4069 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.4075 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

4070 4076 

4071 - `error: optional string or null`4077 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

4078 

4079 The error from the tool call, if any.

4080 

4081 - `string`

4072 4082 

4073 The error from the tool call, if any.4083 The error from the tool call, if any.

4074 4084 

4085 - `McpProtocolError object { code, message, type }`

4086 

4087 - `code: number`

4088 

4089 - `message: string`

4090 

4091 - `type: "mcp_protocol_error"`

4092 

4093 - `"mcp_protocol_error"`

4094 

4095 - `McpToolExecutionError object { content, type }`

4096 

4097 - `content: unknown`

4098 

4099 - `type: "mcp_tool_execution_error"`

4100 

4101 - `"mcp_tool_execution_error"`

4102 

4103 - `HTTPError object { code, message, type }`

4104 

4105 - `code: number`

4106 

4107 - `message: string`

4108 

4109 - `type: "http_error"`

4110 

4111 - `"http_error"`

4112 

4075 - `output: optional string or null`4113 - `output: optional string or null`

4076 4114 

4077 The output from the tool call.4115 The output from the tool call.


7537 for reasoning items returned by `POST /v1/responses` and WebSocket7575 for reasoning items returned by `POST /v1/responses` and WebSocket

7538 `response.create` requests.7576 `response.create` requests.

7539 7577 

7578 When streaming, use the completed reasoning item and its

7579 `encrypted_content` from the `response.output_item.done` event in

7580 subsequent requests. The `encrypted_content` in

7581 `response.output_item.added` may be incomplete. This is especially

7582 important when `store` is `false` or when using Zero Data Retention.

7583 

7540 - `status: optional "in_progress" or "completed" or "incomplete"`7584 - `status: optional "in_progress" or "completed" or "incomplete"`

7541 7585 

7542 The status of the item. One of `in_progress`, `completed`, or7586 The status of the item. One of `in_progress`, `completed`, or


8200 Unique identifier for the MCP tool call approval request.8244 Unique identifier for the MCP tool call approval request.

8201 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.8245 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

8202 8246 

8203 - `error: optional string or null`8247 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

8248 

8249 The error from the tool call, if any.

8250 

8251 - `string`

8204 8252 

8205 The error from the tool call, if any.8253 The error from the tool call, if any.

8206 8254 

8255 - `McpProtocolError object { code, message, type }`

8256 

8257 - `code: number`

8258 

8259 - `message: string`

8260 

8261 - `type: "mcp_protocol_error"`

8262 

8263 - `"mcp_protocol_error"`

8264 

8265 - `McpToolExecutionError object { content, type }`

8266 

8267 - `content: unknown`

8268 

8269 - `type: "mcp_tool_execution_error"`

8270 

8271 - `"mcp_tool_execution_error"`

8272 

8273 - `HTTPError object { code, message, type }`

8274 

8275 - `code: number`

8276 

8277 - `message: string`

8278 

8279 - `type: "http_error"`

8280 

8281 - `"http_error"`

8282 

8207 - `output: optional string or null`8283 - `output: optional string or null`

8208 8284 

8209 The output from the tool call.8285 The output from the tool call.

Details

3261 for reasoning items returned by `POST /v1/responses` and WebSocket3261 for reasoning items returned by `POST /v1/responses` and WebSocket

3262 `response.create` requests.3262 `response.create` requests.

3263 3263 

3264 When streaming, use the completed reasoning item and its

3265 `encrypted_content` from the `response.output_item.done` event in

3266 subsequent requests. The `encrypted_content` in

3267 `response.output_item.added` may be incomplete. This is especially

3268 important when `store` is `false` or when using Zero Data Retention.

3269 

3264 - `status: optional "in_progress" or "completed" or "incomplete"`3270 - `status: optional "in_progress" or "completed" or "incomplete"`

3265 3271 

3266 The status of the item. One of `in_progress`, `completed`, or3272 The status of the item. One of `in_progress`, `completed`, or


3930 Unique identifier for the MCP tool call approval request.3936 Unique identifier for the MCP tool call approval request.

3931 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.3937 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

3932 3938 

3933 - `error: optional string or null`3939 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

3934 3940 

3935 The error from the tool call, if any.3941 The error from the tool call, if any.

3936 3942 

3943 - `string`

3944 

3945 The error from the tool call, if any.

3946 

3947 - `McpProtocolError object { code, message, type }`

3948 

3949 - `code: number`

3950 

3951 - `message: string`

3952 

3953 - `type: "mcp_protocol_error"`

3954 

3955 - `"mcp_protocol_error"`

3956 

3957 - `McpToolExecutionError object { content, type }`

3958 

3959 - `content: unknown`

3960 

3961 - `type: "mcp_tool_execution_error"`

3962 

3963 - `"mcp_tool_execution_error"`

3964 

3965 - `HTTPError object { code, message, type }`

3966 

3967 - `code: number`

3968 

3969 - `message: string`

3970 

3971 - `type: "http_error"`

3972 

3973 - `"http_error"`

3974 

3937 - `output: optional string or null`3975 - `output: optional string or null`

3938 3976 

3939 The output from the tool call.3977 The output from the tool call.


9051 for reasoning items returned by `POST /v1/responses` and WebSocket9089 for reasoning items returned by `POST /v1/responses` and WebSocket

9052 `response.create` requests.9090 `response.create` requests.

9053 9091 

9092 When streaming, use the completed reasoning item and its

9093 `encrypted_content` from the `response.output_item.done` event in

9094 subsequent requests. The `encrypted_content` in

9095 `response.output_item.added` may be incomplete. This is especially

9096 important when `store` is `false` or when using Zero Data Retention.

9097 

9054 - `status: optional "in_progress" or "completed" or "incomplete"`9098 - `status: optional "in_progress" or "completed" or "incomplete"`

9055 9099 

9056 The status of the item. One of `in_progress`, `completed`, or9100 The status of the item. One of `in_progress`, `completed`, or


9720 Unique identifier for the MCP tool call approval request.9764 Unique identifier for the MCP tool call approval request.

9721 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.9765 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

9722 9766 

9723 - `error: optional string or null`9767 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

9768 

9769 The error from the tool call, if any.

9770 

9771 - `string`

9724 9772 

9725 The error from the tool call, if any.9773 The error from the tool call, if any.

9726 9774 

9775 - `McpProtocolError object { code, message, type }`

9776 

9777 - `code: number`

9778 

9779 - `message: string`

9780 

9781 - `type: "mcp_protocol_error"`

9782 

9783 - `"mcp_protocol_error"`

9784 

9785 - `McpToolExecutionError object { content, type }`

9786 

9787 - `content: unknown`

9788 

9789 - `type: "mcp_tool_execution_error"`

9790 

9791 - `"mcp_tool_execution_error"`

9792 

9793 - `HTTPError object { code, message, type }`

9794 

9795 - `code: number`

9796 

9797 - `message: string`

9798 

9799 - `type: "http_error"`

9800 

9801 - `"http_error"`

9802 

9727 - `output: optional string or null`9803 - `output: optional string or null`

9728 9804 

9729 The output from the tool call.9805 The output from the tool call.


10654 for reasoning items returned by `POST /v1/responses` and WebSocket10730 for reasoning items returned by `POST /v1/responses` and WebSocket

10655 `response.create` requests.10731 `response.create` requests.

10656 10732 

10733 When streaming, use the completed reasoning item and its

10734 `encrypted_content` from the `response.output_item.done` event in

10735 subsequent requests. The `encrypted_content` in

10736 `response.output_item.added` may be incomplete. This is especially

10737 important when `store` is `false` or when using Zero Data Retention.

10738 

10657 - `status: optional "in_progress" or "completed" or "incomplete"`10739 - `status: optional "in_progress" or "completed" or "incomplete"`

10658 10740 

10659 The status of the item. One of `in_progress`, `completed`, or10741 The status of the item. One of `in_progress`, `completed`, or


13051 Unique identifier for the MCP tool call approval request.13133 Unique identifier for the MCP tool call approval request.

13052 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.13134 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

13053 13135 

13054 - `error: optional string or null`13136 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

13137 

13138 The error from the tool call, if any.

13139 

13140 - `string`

13055 13141 

13056 The error from the tool call, if any.13142 The error from the tool call, if any.

13057 13143 

13144 - `McpProtocolError object { code, message, type }`

13145 

13146 - `code: number`

13147 

13148 - `message: string`

13149 

13150 - `type: "mcp_protocol_error"`

13151 

13152 - `"mcp_protocol_error"`

13153 

13154 - `McpToolExecutionError object { content, type }`

13155 

13156 - `content: unknown`

13157 

13158 - `type: "mcp_tool_execution_error"`

13159 

13160 - `"mcp_tool_execution_error"`

13161 

13162 - `HTTPError object { code, message, type }`

13163 

13164 - `code: number`

13165 

13166 - `message: string`

13167 

13168 - `type: "http_error"`

13169 

13170 - `"http_error"`

13171 

13058 - `output: optional string or null`13172 - `output: optional string or null`

13059 13173 

13060 The output from the tool call.13174 The output from the tool call.

Details

3313 for reasoning items returned by `POST /v1/responses` and WebSocket3313 for reasoning items returned by `POST /v1/responses` and WebSocket

3314 `response.create` requests.3314 `response.create` requests.

3315 3315 

3316 When streaming, use the completed reasoning item and its

3317 `encrypted_content` from the `response.output_item.done` event in

3318 subsequent requests. The `encrypted_content` in

3319 `response.output_item.added` may be incomplete. This is especially

3320 important when `store` is `false` or when using Zero Data Retention.

3321 

3316 - `status: optional "in_progress" or "completed" or "incomplete"`3322 - `status: optional "in_progress" or "completed" or "incomplete"`

3317 3323 

3318 The status of the item. One of `in_progress`, `completed`, or3324 The status of the item. One of `in_progress`, `completed`, or


3982 Unique identifier for the MCP tool call approval request.3988 Unique identifier for the MCP tool call approval request.

3983 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.3989 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

3984 3990 

3985 - `error: optional string or null`3991 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

3992 

3993 The error from the tool call, if any.

3994 

3995 - `string`

3986 3996 

3987 The error from the tool call, if any.3997 The error from the tool call, if any.

3988 3998 

3999 - `McpProtocolError object { code, message, type }`

4000 

4001 - `code: number`

4002 

4003 - `message: string`

4004 

4005 - `type: "mcp_protocol_error"`

4006 

4007 - `"mcp_protocol_error"`

4008 

4009 - `McpToolExecutionError object { content, type }`

4010 

4011 - `content: unknown`

4012 

4013 - `type: "mcp_tool_execution_error"`

4014 

4015 - `"mcp_tool_execution_error"`

4016 

4017 - `HTTPError object { code, message, type }`

4018 

4019 - `code: number`

4020 

4021 - `message: string`

4022 

4023 - `type: "http_error"`

4024 

4025 - `"http_error"`

4026 

3989 - `output: optional string or null`4027 - `output: optional string or null`

3990 4028 

3991 The output from the tool call.4029 The output from the tool call.


4916 for reasoning items returned by `POST /v1/responses` and WebSocket4954 for reasoning items returned by `POST /v1/responses` and WebSocket

4917 `response.create` requests.4955 `response.create` requests.

4918 4956 

4957 When streaming, use the completed reasoning item and its

4958 `encrypted_content` from the `response.output_item.done` event in

4959 subsequent requests. The `encrypted_content` in

4960 `response.output_item.added` may be incomplete. This is especially

4961 important when `store` is `false` or when using Zero Data Retention.

4962 

4919 - `status: optional "in_progress" or "completed" or "incomplete"`4963 - `status: optional "in_progress" or "completed" or "incomplete"`

4920 4964 

4921 The status of the item. One of `in_progress`, `completed`, or4965 The status of the item. One of `in_progress`, `completed`, or


7313 Unique identifier for the MCP tool call approval request.7357 Unique identifier for the MCP tool call approval request.

7314 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.7358 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

7315 7359 

7316 - `error: optional string or null`7360 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

7361 

7362 The error from the tool call, if any.

7363 

7364 - `string`

7317 7365 

7318 The error from the tool call, if any.7366 The error from the tool call, if any.

7319 7367 

7368 - `McpProtocolError object { code, message, type }`

7369 

7370 - `code: number`

7371 

7372 - `message: string`

7373 

7374 - `type: "mcp_protocol_error"`

7375 

7376 - `"mcp_protocol_error"`

7377 

7378 - `McpToolExecutionError object { content, type }`

7379 

7380 - `content: unknown`

7381 

7382 - `type: "mcp_tool_execution_error"`

7383 

7384 - `"mcp_tool_execution_error"`

7385 

7386 - `HTTPError object { code, message, type }`

7387 

7388 - `code: number`

7389 

7390 - `message: string`

7391 

7392 - `type: "http_error"`

7393 

7394 - `"http_error"`

7395 

7320 - `output: optional string or null`7396 - `output: optional string or null`

7321 7397 

7322 The output from the tool call.7398 The output from the tool call.

Details

3112 for reasoning items returned by `POST /v1/responses` and WebSocket3112 for reasoning items returned by `POST /v1/responses` and WebSocket

3113 `response.create` requests.3113 `response.create` requests.

3114 3114 

3115 When streaming, use the completed reasoning item and its

3116 `encrypted_content` from the `response.output_item.done` event in

3117 subsequent requests. The `encrypted_content` in

3118 `response.output_item.added` may be incomplete. This is especially

3119 important when `store` is `false` or when using Zero Data Retention.

3120 

3115 - `status: optional "in_progress" or "completed" or "incomplete"`3121 - `status: optional "in_progress" or "completed" or "incomplete"`

3116 3122 

3117 The status of the item. One of `in_progress`, `completed`, or3123 The status of the item. One of `in_progress`, `completed`, or


3857 Unique identifier for the MCP tool call approval request.3863 Unique identifier for the MCP tool call approval request.

3858 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.3864 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

3859 3865 

3860 - `error: optional string or null`3866 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

3867 

3868 The error from the tool call, if any.

3869 

3870 - `string`

3861 3871 

3862 The error from the tool call, if any.3872 The error from the tool call, if any.

3863 3873 

3874 - `McpProtocolError object { code, message, type }`

3875 

3876 - `code: number`

3877 

3878 - `message: string`

3879 

3880 - `type: "mcp_protocol_error"`

3881 

3882 - `"mcp_protocol_error"`

3883 

3884 - `McpToolExecutionError object { content, type }`

3885 

3886 - `content: unknown`

3887 

3888 - `type: "mcp_tool_execution_error"`

3889 

3890 - `"mcp_tool_execution_error"`

3891 

3892 - `HTTPError object { code, message, type }`

3893 

3894 - `code: number`

3895 

3896 - `message: string`

3897 

3898 - `type: "http_error"`

3899 

3900 - `"http_error"`

3901 

3864 - `output: optional string or null`3902 - `output: optional string or null`

3865 3903 

3866 The output from the tool call.3904 The output from the tool call.


7168 for reasoning items returned by `POST /v1/responses` and WebSocket7206 for reasoning items returned by `POST /v1/responses` and WebSocket

7169 `response.create` requests.7207 `response.create` requests.

7170 7208 

7209 When streaming, use the completed reasoning item and its

7210 `encrypted_content` from the `response.output_item.done` event in

7211 subsequent requests. The `encrypted_content` in

7212 `response.output_item.added` may be incomplete. This is especially

7213 important when `store` is `false` or when using Zero Data Retention.

7214 

7171 - `status: optional "in_progress" or "completed" or "incomplete"`7215 - `status: optional "in_progress" or "completed" or "incomplete"`

7172 7216 

7173 The status of the item. One of `in_progress`, `completed`, or7217 The status of the item. One of `in_progress`, `completed`, or


7913 Unique identifier for the MCP tool call approval request.7957 Unique identifier for the MCP tool call approval request.

7914 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.7958 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

7915 7959 

7916 - `error: optional string or null`7960 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

7961 

7962 The error from the tool call, if any.

7963 

7964 - `string`

7917 7965 

7918 The error from the tool call, if any.7966 The error from the tool call, if any.

7919 7967 

7968 - `McpProtocolError object { code, message, type }`

7969 

7970 - `code: number`

7971 

7972 - `message: string`

7973 

7974 - `type: "mcp_protocol_error"`

7975 

7976 - `"mcp_protocol_error"`

7977 

7978 - `McpToolExecutionError object { content, type }`

7979 

7980 - `content: unknown`

7981 

7982 - `type: "mcp_tool_execution_error"`

7983 

7984 - `"mcp_tool_execution_error"`

7985 

7986 - `HTTPError object { code, message, type }`

7987 

7988 - `code: number`

7989 

7990 - `message: string`

7991 

7992 - `type: "http_error"`

7993 

7994 - `"http_error"`

7995 

7920 - `output: optional string or null`7996 - `output: optional string or null`

7921 7997 

7922 The output from the tool call.7998 The output from the tool call.

Details

3110 for reasoning items returned by `POST /v1/responses` and WebSocket3110 for reasoning items returned by `POST /v1/responses` and WebSocket

3111 `response.create` requests.3111 `response.create` requests.

3112 3112 

3113 When streaming, use the completed reasoning item and its

3114 `encrypted_content` from the `response.output_item.done` event in

3115 subsequent requests. The `encrypted_content` in

3116 `response.output_item.added` may be incomplete. This is especially

3117 important when `store` is `false` or when using Zero Data Retention.

3118 

3113 - `status: optional "in_progress" or "completed" or "incomplete"`3119 - `status: optional "in_progress" or "completed" or "incomplete"`

3114 3120 

3115 The status of the item. One of `in_progress`, `completed`, or3121 The status of the item. One of `in_progress`, `completed`, or


3855 Unique identifier for the MCP tool call approval request.3861 Unique identifier for the MCP tool call approval request.

3856 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.3862 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

3857 3863 

3858 - `error: optional string or null`3864 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

3865 

3866 The error from the tool call, if any.

3867 

3868 - `string`

3859 3869 

3860 The error from the tool call, if any.3870 The error from the tool call, if any.

3861 3871 

3872 - `McpProtocolError object { code, message, type }`

3873 

3874 - `code: number`

3875 

3876 - `message: string`

3877 

3878 - `type: "mcp_protocol_error"`

3879 

3880 - `"mcp_protocol_error"`

3881 

3882 - `McpToolExecutionError object { content, type }`

3883 

3884 - `content: unknown`

3885 

3886 - `type: "mcp_tool_execution_error"`

3887 

3888 - `"mcp_tool_execution_error"`

3889 

3890 - `HTTPError object { code, message, type }`

3891 

3892 - `code: number`

3893 

3894 - `message: string`

3895 

3896 - `type: "http_error"`

3897 

3898 - `"http_error"`

3899 

3862 - `output: optional string or null`3900 - `output: optional string or null`

3863 3901 

3864 The output from the tool call.3902 The output from the tool call.

Details

3204 for reasoning items returned by `POST /v1/responses` and WebSocket3204 for reasoning items returned by `POST /v1/responses` and WebSocket

3205 `response.create` requests.3205 `response.create` requests.

3206 3206 

3207 When streaming, use the completed reasoning item and its

3208 `encrypted_content` from the `response.output_item.done` event in

3209 subsequent requests. The `encrypted_content` in

3210 `response.output_item.added` may be incomplete. This is especially

3211 important when `store` is `false` or when using Zero Data Retention.

3212 

3207 - `status: optional "in_progress" or "completed" or "incomplete"`3213 - `status: optional "in_progress" or "completed" or "incomplete"`

3208 3214 

3209 The status of the item. One of `in_progress`, `completed`, or3215 The status of the item. One of `in_progress`, `completed`, or


3873 Unique identifier for the MCP tool call approval request.3879 Unique identifier for the MCP tool call approval request.

3874 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.3880 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

3875 3881 

3876 - `error: optional string or null`3882 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

3883 

3884 The error from the tool call, if any.

3885 

3886 - `string`

3877 3887 

3878 The error from the tool call, if any.3888 The error from the tool call, if any.

3879 3889 

3890 - `McpProtocolError object { code, message, type }`

3891 

3892 - `code: number`

3893 

3894 - `message: string`

3895 

3896 - `type: "mcp_protocol_error"`

3897 

3898 - `"mcp_protocol_error"`

3899 

3900 - `McpToolExecutionError object { content, type }`

3901 

3902 - `content: unknown`

3903 

3904 - `type: "mcp_tool_execution_error"`

3905 

3906 - `"mcp_tool_execution_error"`

3907 

3908 - `HTTPError object { code, message, type }`

3909 

3910 - `code: number`

3911 

3912 - `message: string`

3913 

3914 - `type: "http_error"`

3915 

3916 - `"http_error"`

3917 

3880 - `output: optional string or null`3918 - `output: optional string or null`

3881 3919 

3882 The output from the tool call.3920 The output from the tool call.

Details

3202 for reasoning items returned by `POST /v1/responses` and WebSocket3202 for reasoning items returned by `POST /v1/responses` and WebSocket

3203 `response.create` requests.3203 `response.create` requests.

3204 3204 

3205 When streaming, use the completed reasoning item and its

3206 `encrypted_content` from the `response.output_item.done` event in

3207 subsequent requests. The `encrypted_content` in

3208 `response.output_item.added` may be incomplete. This is especially

3209 important when `store` is `false` or when using Zero Data Retention.

3210 

3205 - `status: optional "in_progress" or "completed" or "incomplete"`3211 - `status: optional "in_progress" or "completed" or "incomplete"`

3206 3212 

3207 The status of the item. One of `in_progress`, `completed`, or3213 The status of the item. One of `in_progress`, `completed`, or


3871 Unique identifier for the MCP tool call approval request.3877 Unique identifier for the MCP tool call approval request.

3872 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.3878 Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.

3873 3879 

3874 - `error: optional string or null`3880 - `error: optional string or object { code, message, type } or object { content, type } or object { code, message, type } or null`

3881 

3882 The error from the tool call, if any.

3883 

3884 - `string`

3875 3885 

3876 The error from the tool call, if any.3886 The error from the tool call, if any.

3877 3887 

3888 - `McpProtocolError object { code, message, type }`

3889 

3890 - `code: number`

3891 

3892 - `message: string`

3893 

3894 - `type: "mcp_protocol_error"`

3895 

3896 - `"mcp_protocol_error"`

3897 

3898 - `McpToolExecutionError object { content, type }`

3899 

3900 - `content: unknown`

3901 

3902 - `type: "mcp_tool_execution_error"`

3903 

3904 - `"mcp_tool_execution_error"`

3905 

3906 - `HTTPError object { code, message, type }`

3907 

3908 - `code: number`

3909 

3910 - `message: string`

3911 

3912 - `type: "http_error"`

3913 

3914 - `"http_error"`

3915 

3878 - `output: optional string or null`3916 - `output: optional string or null`

3879 3917 

3880 The output from the tool call.3918 The output from the tool call.

ruby/index.md +10 −10

Details

15<!-- x-release-please-start-version -->15<!-- x-release-please-start-version -->

16 16 

17```ruby17```ruby

18gem "openai", "~> 0.78.0"18gem "openai", "~> 0.79.0"

19```19```

20 20 

21<!-- x-release-please-end -->21<!-- x-release-please-end -->


669| `:error` | Terminal request failures after retries are exhausted |669| `:error` | Terminal request failures after retries are exhausted |

670| `:warn` | Error events plus retry reason and delay |670| `:warn` | Error events plus retry reason and delay |

671| `:info` | Safe request completion summaries |671| `:info` | Safe request completion summaries |

672| `:debug` | Per-attempt headers and bounded body diagnostics |672| `:debug` | Per-attempt headers and bounded structural body diagnostics |

673 673 

674Info, warning, and error logs include operational fields such as the HTTP674Info, warning, and error logs include operational fields such as the HTTP

675method, sanitized path, status, request ID, duration, and attempt count. They675method, sanitized path, status, request ID, duration, and attempt count. They


677and query parameters, including authorization, API-key, cookie, token,677and query parameters, including authorization, API-key, cookie, token,

678credential, and signature values.678credential, and signature values.

679 679 

680Debug logging can still disclose sensitive prompts, model responses, and tool680Debug body diagnostics never include customer-controlled object keys, string

681arguments. Do not enable it in production unless your log destination and data681values, prompts, model responses, tool arguments, form fields, or signed URLs.

682retention policy are appropriate. The built-in logger omits uploaded file682JSON bodies report only their byte size, top-level type, and object-field or

683contents, multipart bodies, binary bodies, large opaque/base64-like values, and683array-item count; form bodies report only their byte size and field count. The

684server-sent event contents. Text bodies are truncated to a fixed bound;684built-in logger omits uploaded file contents, multipart bodies, binary bodies,

685oversized JSON and incomplete bodies are marked as omitted. Response bodies are685server-sent event contents, unsupported text bodies, oversized bodies, and

686observed only as the application consumes them and are never read eagerly for686incomplete bodies. Response bodies are observed only as the application consumes

687logging.687them and are never read eagerly for logging.

688 688 

689SDK log messages are intended for human diagnostics. Their text format is not689SDK log messages are intended for human diagnostics. Their text format is not

690a stable structured-event API and may change between releases. Exceptions from690a stable structured-event API and may change between releases. Exceptions from