Skip to main content

List the chats of the authenticated user

GET/v2/aissistant-chats
API version
v2
Request method
GET
Operation ID
aissistant-list-chats

Returns at most 50 chats, sorted by updatedAt in descending order, so the chat saved last comes first. A chat carries its message list only when it is read on its own.

Request​

No request parameters.

Responses​

Format
application/json
Description

A list of the caller's chats, at most 50, sorted by updatedAt in descending order.

  • Array[
    • *object
      • idstring (uuid)required
      • titlestringrequired

        At most 200 UTF-16 code units on save. Some titles were stored before that limit existed and can be longer; they are still returned.

      • updatedAtstring (date-time)required
    ]
The caller has no chat
Content-Type: application/json

[]
Two saved chats
Content-Type: application/json

[
{
"id": "7f0c6a52-3a8e-4b8f-9d1e-2c4b5a6d7e8f",
"title": "Set up a domain for my project",
"updatedAt": "2026-10-29T10:15:00.000Z"
},
{
"id": "0b7d1c3e-5f60-4a2b-8c9d-e0f1a2b3c4d5",
"title": "Why is my cronjob failing?",
"updatedAt": "2026-10-28T16:40:00.000Z"
}
]
{
"example": [
{
"id": "7f0c6a52-3a8e-4b8f-9d1e-2c4b5a6d7e8f",
"title": "Set up a domain for my project",
"updatedAt": "2026-10-29T10:15:00.000Z"
}
],
"items": {
"additionalProperties": false,
"example": {
"id": "7f0c6a52-3a8e-4b8f-9d1e-2c4b5a6d7e8f",
"title": "Set up a domain for my project",
"updatedAt": "2026-10-29T10:15:00.000Z"
},
"properties": {
"id": {
"format": "uuid",
"type": "string"
},
"title": {
"description": "At most 200 UTF-16 code units on save. Some titles were stored before that limit existed and can be longer; they are still returned.",
"type": "string"
},
"updatedAt": {
"format": "date-time",
"type": "string"
}
},
"required": [
"id",
"title",
"updatedAt"
],
"type": "object"
},
"maxItems": 50,
"type": "array"
}

Usage examples​

$ curl \
--fail \
--location \
-H "Authorization: Bearer $MITTWALD_API_TOKEN" \
https://api.mittwald.de/v2/aissistant-chats
import { MittwaldAPIV2Client } from "@mittwald/api-client";
import { assertStatus } from "@mittwald/api-client-commons";

const client = MittwaldAPIClient.newWithToken(process.env.MITTWALD_API_TOKEN);
const response = await client.aissistant.listChats({});

assertStatus(response, 200);

use \Mittwald\ApiClient\Generated\V2\Clients\AIssistant\ListChats\ListChatsRequest;

$client = MittwaldAPIClient::newWithToken(getenv('MITTWALD_API_TOKEN'));

$request = (new ListChatsRequest());
$response = $client->aissistant()->listChats($request);

var_dump($response->getBody();

On this page