Assistants

Modify message

Changed on Oct 6, 2026

Modifies a message.

post/threads/{thread_id}/messages/{message_id}

Request

Base URL
https://api.openai.com/v1
URL
https://api.openai.com/v1/threads/{thread_id}/messages/{message_id}
Auth
HTTP bearer

Path parameters

thread_idstring required

The ID of the thread to which this message belongs.

message_idstring required

The ID of the message to modify.

Request body

metadataMetadata nullable

Set of 16 key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format, and querying for objects via API or the dashboard.

Keys are strings with a maximum length of 64 characters. Values are strings with a maximum length of 512 characters.

Response

idstring required

The identifier, which can be referenced in API endpoints.

object'thread.message' required

The object type, which is always thread.message.

created_atinteger required

The Unix timestamp (in seconds) for when the message was created.

thread_idstring required

The thread ID that this message belongs to.

status'in_progress' | 'incomplete' | 'completed' required

The status of the message, which can be either in_progress, incomplete, or completed.

completed_atinteger nullable required

The Unix timestamp (in seconds) for when the message was completed.

incomplete_atinteger nullable required

The Unix timestamp (in seconds) for when the message was marked as incomplete.

role'user' | 'assistant' required

The entity that produced the message. One of user or assistant.

assistant_idstring nullable required

If applicable, the ID of the assistant that authored this message.

run_idstring nullable required

The ID of the run associated with the creation of this message. Value is null when messages are created manually using the create message or create thread endpoints.

metadataMetadata nullable required