List Chats

This endpoint retrieves a list of chats within a specific assistant session in TaskingAI.

Endpoint

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

Path Parameters

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

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 chats to retrieve.
order	string or null	No	desc	Defines the sort order. Can accept values from asc or desc. The sort key is updated_timestamp.
after	string or null	No	null	A cursor indicating to retrieve chats after a certain identifier.
before	string or null	No	null	A cursor indicating to retrieve chats before a certain identifier.

Response Example

{
  "status": "success",
  "data": [
    {
      "object": "Chat",
      "chat_id": "chat_1",
      "assistant_id": "assistant_1",
      "name": "Name",
      "metadata": {},
      "updated_timestamp": 1730210035453,
      "created_timestamp": 1730210035453
    },
    ...
  ],
  "fetched_count": 20,
  "has_more": true
}