Create User Message

This endpoint allows you to create a new message within a specific chat session in TaskingAI.

Endpoint

• Method: POST
• URL: https://api.tasking.ai/v1/assistants/{assistant_id}/chats/{chat_id}/messages

Path Parameters

Parameter	Type	Description
assistant_id	string	The unique identifier for the assistant.
chat_id	string	The unique identifier for the chat.

Header Parameters

All TaskingAI API requests require the following headers:

Header	Type	Description
Content-Type	string	The content type of the request. Set to application/json.
Authorization	string	API key for authorization in the format Bearer $TASKINGAI_API_KEY. The key can be obtained in the project settings in your TaskingAI console.

Payload Parameters

Request Body (application/json)

Parameter	Type	Required	Default	Description
role	string	Yes		The role of the message. Can be either user or assistant.
content	object	Yes		The message content, which must include the text field.
metadata	object	No	{}	Metadata for the message. Can store up to 16 key-value pairs, each with key lengths < 64 and value lengths < 512.

Request Example

{
    "role": "user",
    "content": {
        "text": "What's the weather like today in New York?"
    },
    "metadata": {}
}

Response Example

{
  "status": "success",
  "data": {
      "object": "Message",
      "message_id": "message_1",
      "chat_id": "chat_1",
      "assistant_id": "assistant_1",
      "role": "user",
      "content": {"text": "What's the weather like today in New York?"},
      "metadata": {},
      "updated_timestamp": 1730210035453,
      "created_timestamp": 1730210035453
  }
}