POST
/
threads
/
{thread_id}
/
messages
curl --request POST \
  --url https://api.openai.com/v1/threads/{thread_id}/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "role": "user",
  "content": "<string>",
  "attachments": [
    {
      "file_id": "<string>",
      "tools": [
        {
          "type": "code_interpreter"
        }
      ]
    }
  ],
  "metadata": {}
}'
{
  "id": "<string>",
  "object": "thread.message",
  "created_at": 123,
  "thread_id": "<string>",
  "status": "in_progress",
  "incomplete_details": {
    "reason": "content_filter"
  },
  "completed_at": 123,
  "incomplete_at": 123,
  "role": "user",
  "content": [
    {
      "type": "image_file",
      "image_file": {
        "file_id": "<string>",
        "detail": "auto"
      }
    }
  ],
  "assistant_id": "<string>",
  "run_id": "<string>",
  "attachments": [
    {
      "file_id": "<string>",
      "tools": [
        {
          "type": "code_interpreter"
        }
      ]
    }
  ],
  "metadata": {}
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
thread_id
string
required

The ID of the thread to create a message for.

Body

application/json

Response

200 - application/json

OK

Represents a message within a thread.