---
title: "OutputMessageItem"
---

An output message item


## Fields

| Field                                                                                                                                                                                                                                                                                                                                  | Type                                                                                                                                                                                                                                                                                                                                   | Required                                                                                                                                                                                                                                                                                                                               | Description                                                                                                                                                                                                                                                                                                                            |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `content`                                                                                                                                                                                                                                                                                                                              | List[[components.OutputMessageItemContent](../components/outputmessageitemcontent.mdx)]                                                                                                                                                                                                                                                 | :heavy_check_mark:                                                                                                                                                                                                                                                                                                                     | N/A                                                                                                                                                                                                                                                                                                                                    |
| `id`                                                                                                                                                                                                                                                                                                                                   | *str*                                                                                                                                                                                                                                                                                                                                  | :heavy_check_mark:                                                                                                                                                                                                                                                                                                                     | N/A                                                                                                                                                                                                                                                                                                                                    |
| `phase`                                                                                                                                                                                                                                                                                                                                | [OptionalNullable[components.OutputMessageItemPhaseUnion]](../components/outputmessageitemphaseunion.mdx)                                                                                                                                                                                                                               | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                     | The phase of an assistant message. Use `commentary` for an intermediate assistant message and `final_answer` for the final assistant message. For follow-up requests with models like `gpt-5.3-codex` and later, preserve and resend phase on all assistant messages. Omitting it can degrade performance. Not used for user messages. |
| `role`                                                                                                                                                                                                                                                                                                                                 | [components.OutputMessageItemRole](../components/outputmessageitemrole.mdx)                                                                                                                                                                                                                                                             | :heavy_check_mark:                                                                                                                                                                                                                                                                                                                     | N/A                                                                                                                                                                                                                                                                                                                                    |
| `status`                                                                                                                                                                                                                                                                                                                               | [Optional[components.OutputMessageItemStatusUnion]](../components/outputmessageitemstatusunion.mdx)                                                                                                                                                                                                                                     | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                     | N/A                                                                                                                                                                                                                                                                                                                                    |
| `type`                                                                                                                                                                                                                                                                                                                                 | [components.OutputMessageItemType](../components/outputmessageitemtype.mdx)                                                                                                                                                                                                                                                             | :heavy_check_mark:                                                                                                                                                                                                                                                                                                                     | N/A                                                                                                                                                                                                                                                                                                                                    |