curl -X POST "https://mdb.ai/threads/mdb_thread_cfa0fac64cd94faab3ae269d768c0cb0/messages" \
  -H "Authorization: Bearer MINDS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "role": "user",
      "content": "What data do you have access to?"
  }'
{
    "id": "mdb_msg_7a74bc341b194af1ab8228e57a85d462",
    "assistant_id": null,
    "attachments": null,
    "completed_at": null,
    "content": [
        {
            "text": {
                "annotations": [],
                "value": "What data do you have access to?"
            },
            "type": "text"
        }
    ],
    "created_at": 1718885284.3509543,
    "incomplete_at": null,
    "incomplete_details": null,
    "metadata": null,
    "object": null,
    "role": "user",
    "run_id": null,
    "status": null,
    "thread_id": "mdb_thread_cfa0fac64cd94faab3ae269d768c0cb0"
}

This API endpoint creates a Message in a Thread using the POST method.

​
Body

​
role
string
required

Role used to send a Message (e.g., “user” or “assistant”).

​
content
string
required

A Message to be posted to a Thread.

​
Response

​
id
string
required

Unique identifier for the created message.

​
assistant_id
string

ID of the assistant, if applicable.

​
attachments
array

Any attachments associated with the message.

​
completed_at
number

Timestamp when the message was completed.

​
content
array
required

Content of the message, including text and annotations.

​
created_at
number
required

Timestamp when the message was created.

​
incomplete_at
number

Timestamp when the message became incomplete, if applicable.

​
incomplete_details
object

Details on why the message was incomplete.

​
metadata
object

Additional metadata about the message.

​
object
string

Type of the object.

​
role
string
required

The role that generated the message.

​
run_id
string

Run ID associated with the message.

​
status
string

Status of the message.

​
thread_id
string
required

ID of the thread the message belongs to.

​
Authorization

A valid API key must be passed in the Authorization header:

Authorization: Bearer MINDS_API_KEY

Generate your API key here.

​
Path Parameters

​
thread_id
string
required

Id of the Thread to post the message to.

curl -X POST "https://mdb.ai/threads/mdb_thread_cfa0fac64cd94faab3ae269d768c0cb0/messages" \
  -H "Authorization: Bearer MINDS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "role": "user",
      "content": "What data do you have access to?"
  }'
{
    "id": "mdb_msg_7a74bc341b194af1ab8228e57a85d462",
    "assistant_id": null,
    "attachments": null,
    "completed_at": null,
    "content": [
        {
            "text": {
                "annotations": [],
                "value": "What data do you have access to?"
            },
            "type": "text"
        }
    ],
    "created_at": 1718885284.3509543,
    "incomplete_at": null,
    "incomplete_details": null,
    "metadata": null,
    "object": null,
    "role": "user",
    "run_id": null,
    "status": null,
    "thread_id": "mdb_thread_cfa0fac64cd94faab3ae269d768c0cb0"
}