---
title: "OutputMessage"
---

## Fields

| Field                                                                                                                                                                                                                                                                                                                                  | Type                                                                                                                                                                                                                                                                                                                                   | Required                                                                                                                                                                                                                                                                                                                               | Description                                                                                                                                                                                                                                                                                                                            |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `content`                                                                                                                                                                                                                                                                                                                              | List[[components.OutputMessageContent](../components/outputmessagecontent.mdx)]                                                                                                                                                                                                                                                         | :heavy_check_mark:                                                                                                                                                                                                                                                                                                                     | N/A                                                                                                                                                                                                                                                                                                                                    |
| `id`                                                                                                                                                                                                                                                                                                                                   | *str*                                                                                                                                                                                                                                                                                                                                  | :heavy_check_mark:                                                                                                                                                                                                                                                                                                                     | N/A                                                                                                                                                                                                                                                                                                                                    |
| `phase`                                                                                                                                                                                                                                                                                                                                | [OptionalNullable[components.OutputMessagePhaseUnion]](../components/outputmessagephaseunion.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.OutputMessageRole](../components/outputmessagerole.mdx)                                                                                                                                                                                                                                                                     | :heavy_check_mark:                                                                                                                                                                                                                                                                                                                     | N/A                                                                                                                                                                                                                                                                                                                                    |
| `status`                                                                                                                                                                                                                                                                                                                               | [Optional[components.OutputMessageStatusUnion]](../components/outputmessagestatusunion.mdx)                                                                                                                                                                                                                                             | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                     | N/A                                                                                                                                                                                                                                                                                                                                    |
| `type`                                                                                                                                                                                                                                                                                                                                 | [components.OutputMessageType](../components/outputmessagetype.mdx)                                                                                                                                                                                                                                                                     | :heavy_check_mark:                                                                                                                                                                                                                                                                                                                     | N/A                                                                                                                                                                                                                                                                                                                                    |