List Messages

This endpoint retrieves a list of messages within a specific chat session in TaskingAI.

Endpoint

• Method: GET
• 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.

Query Parameters

Parameter	Type	Required	Default	Description
limit	integer	No	20	The maximum number of messages to retrieve.
order	string or null	No	desc	Defines the sort order. Can accept values from asc or desc. The sort key is created_timestamp.
after	string or null	No	null	A cursor indicating to retrieve messages after a certain identifier.
before	string or null	No	null	A cursor indicating to retrieve messages before a certain identifier.

Response Example

{
  "status": "success",
  "data": [
    {
      "object": "Message",
      "message_id": "message_1",
      "chat_id": "chat_1",
      "assistant_id": "assistant_1",
      "role": "assistant",
      "content": {"text": "The weather in New York is 75°F and sunny."},
      "metadata": {},
      "updated_timestamp": 1730210038453,
      "created_timestamp": 1730210038453
    },
    {
      "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
    },
    ...
  ],
  "fetched_count": 20,
  "has_more": true
}