## Update Message `client.messages.update(stringmessageID, MessageUpdateParamsbody, RequestOptionsoptions?): TaskMessage` **put** `/messages/{message_id}` Update Message ### Parameters - `messageID: string` - `body: MessageUpdateParams` - `content: TaskMessageContent` - `TextContent` - `author: MessageAuthor` The role of the messages author, in this case `system`, `user`, `assistant`, or `tool`. - `"user"` - `"agent"` - `content: string` The contents of the text message. - `attachments?: Array | null` Optional list of file attachments with structured metadata. - `file_id: string` The unique ID of the attached file - `name: string` The name of the file - `size: number` The size of the file in bytes - `type: string` The MIME type or content type of the file - `format?: TextFormat` The format of the message. This is used by the client to determine how to display the message. - `"markdown"` - `"plain"` - `"code"` - `style?: MessageStyle` The style of the message. This is used by the client to determine how to display the message. - `"static"` - `"active"` - `type?: "text"` The type of the message, in this case `text`. - `"text"` - `ReasoningContent` - `author: MessageAuthor` The role of the messages author, in this case `system`, `user`, `assistant`, or `tool`. - `summary: Array` A list of short reasoning summaries - `content?: Array | null` The reasoning content or chain-of-thought text - `style?: MessageStyle` The style of the message. This is used by the client to determine how to display the message. - `type?: "reasoning"` The type of the message, in this case `reasoning`. - `"reasoning"` - `DataContent` - `author: MessageAuthor` The role of the messages author, in this case `system`, `user`, `assistant`, or `tool`. - `data: Record` The contents of the data message. - `style?: MessageStyle` The style of the message. This is used by the client to determine how to display the message. - `type?: "data"` The type of the message, in this case `data`. - `"data"` - `ToolRequestContent` - `arguments: Record` The arguments to the tool. - `author: MessageAuthor` The role of the messages author, in this case `system`, `user`, `assistant`, or `tool`. - `name: string` The name of the tool that is being requested. - `tool_call_id: string` The ID of the tool call that is being requested. - `style?: MessageStyle` The style of the message. This is used by the client to determine how to display the message. - `type?: "tool_request"` The type of the message, in this case `tool_request`. - `"tool_request"` - `ToolResponseContent` - `author: MessageAuthor` The role of the messages author, in this case `system`, `user`, `assistant`, or `tool`. - `content: unknown` The result of the tool. - `name: string` The name of the tool that is being responded to. - `tool_call_id: string` The ID of the tool call that is being responded to. - `is_error?: boolean | null` Whether the tool call resulted in an error. `None` when the harness does not report a status. - `style?: MessageStyle` The style of the message. This is used by the client to determine how to display the message. - `type?: "tool_response"` The type of the message, in this case `tool_response`. - `"tool_response"` - `task_id: string` - `streaming_status?: "IN_PROGRESS" | "DONE" | null` - `"IN_PROGRESS"` - `"DONE"` ### Returns - `TaskMessage` Represents a message in the agent system. This entity is used to store messages in MongoDB, with each message associated with a specific task. - `content: TaskMessageContent` The content of the message. This content is not OpenAI compatible. These are messages that are meant to be displayed to the user. - `TextContent` - `author: MessageAuthor` The role of the messages author, in this case `system`, `user`, `assistant`, or `tool`. - `"user"` - `"agent"` - `content: string` The contents of the text message. - `attachments?: Array | null` Optional list of file attachments with structured metadata. - `file_id: string` The unique ID of the attached file - `name: string` The name of the file - `size: number` The size of the file in bytes - `type: string` The MIME type or content type of the file - `format?: TextFormat` The format of the message. This is used by the client to determine how to display the message. - `"markdown"` - `"plain"` - `"code"` - `style?: MessageStyle` The style of the message. This is used by the client to determine how to display the message. - `"static"` - `"active"` - `type?: "text"` The type of the message, in this case `text`. - `"text"` - `ReasoningContent` - `author: MessageAuthor` The role of the messages author, in this case `system`, `user`, `assistant`, or `tool`. - `summary: Array` A list of short reasoning summaries - `content?: Array | null` The reasoning content or chain-of-thought text - `style?: MessageStyle` The style of the message. This is used by the client to determine how to display the message. - `type?: "reasoning"` The type of the message, in this case `reasoning`. - `"reasoning"` - `DataContent` - `author: MessageAuthor` The role of the messages author, in this case `system`, `user`, `assistant`, or `tool`. - `data: Record` The contents of the data message. - `style?: MessageStyle` The style of the message. This is used by the client to determine how to display the message. - `type?: "data"` The type of the message, in this case `data`. - `"data"` - `ToolRequestContent` - `arguments: Record` The arguments to the tool. - `author: MessageAuthor` The role of the messages author, in this case `system`, `user`, `assistant`, or `tool`. - `name: string` The name of the tool that is being requested. - `tool_call_id: string` The ID of the tool call that is being requested. - `style?: MessageStyle` The style of the message. This is used by the client to determine how to display the message. - `type?: "tool_request"` The type of the message, in this case `tool_request`. - `"tool_request"` - `ToolResponseContent` - `author: MessageAuthor` The role of the messages author, in this case `system`, `user`, `assistant`, or `tool`. - `content: unknown` The result of the tool. - `name: string` The name of the tool that is being responded to. - `tool_call_id: string` The ID of the tool call that is being responded to. - `is_error?: boolean | null` Whether the tool call resulted in an error. `None` when the harness does not report a status. - `style?: MessageStyle` The style of the message. This is used by the client to determine how to display the message. - `type?: "tool_response"` The type of the message, in this case `tool_response`. - `"tool_response"` - `task_id: string` ID of the task this message belongs to - `id?: string | null` The task message's unique id - `created_at?: string | null` The timestamp when the message was created - `streaming_status?: "IN_PROGRESS" | "DONE" | null` - `"IN_PROGRESS"` - `"DONE"` - `updated_at?: string | null` The timestamp when the message was last updated ### Example ```typescript import Agentex from 'agentex'; const client = new Agentex({ apiKey: process.env['AGENTEX_SDK_API_KEY'], // This is the default and can be omitted }); const taskMessage = await client.messages.update('message_id', { content: { author: 'user', content: 'content', type: 'text', }, task_id: 'task_id', }); console.log(taskMessage.task_id); ``` #### Response ```json { "content": { "author": "user", "content": "content", "attachments": [ { "file_id": "file_id", "name": "name", "size": 0, "type": "type" } ], "format": "markdown", "style": "static", "type": "text" }, "task_id": "task_id", "id": "id", "created_at": "2019-12-27T18:11:19.117Z", "streaming_status": "IN_PROGRESS", "updated_at": "2019-12-27T18:11:19.117Z" } ```