> ## Documentation Index
> Fetch the complete documentation index at: https://docs.delicious-data.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Chats auflisten

> Chats des Nutzers (eigene und mit ihm geteilte), sortiert nach letzter Aktivität. `title` wird nach der ersten Antwort vom Service gesetzt und kann direkt nach dem Start noch leer sein.



## OpenAPI

````yaml /api-reference/partner-api.json get /chats
openapi: 3.1.0
info:
  title: Delicious AI Partner-API
  version: 1.0.0
  description: >-
    Delicious AI als Chat-Backend für ein eigenes Frontend.


    Alle Pfade liegen unter `/api/public/v1`. Jeder Request braucht das Access
    Token des Nutzers als Bearer Token.
servers:
  - url: >-
      https://delicious-ai-app.wonderfulgrass-3eed3e5c.westeurope.azurecontainerapps.io/api/public/v1
    description: Produktion
security:
  - bearerAuth: []
tags:
  - name: Sitzung
    description: Angemeldeter Nutzer
  - name: Prompts
    description: Prompts des Nutzers
  - name: Chats
    description: Chats anlegen, auflisten, laden, löschen
  - name: Nachrichten
    description: Nachricht senden, Antwort streamen
paths:
  /chats:
    get:
      tags:
        - Chats
      summary: Chats auflisten
      description: >-
        Chats des Nutzers (eigene und mit ihm geteilte), sortiert nach letzter
        Aktivität. `title` wird nach der ersten Antwort vom Service gesetzt und
        kann direkt nach dem Start noch leer sein.
      operationId: listChats
      parameters:
        - name: page
          in: query
          description: Seite, ab 1
          schema:
            type: integer
            minimum: 1
            default: 1
        - name: pageSize
          in: query
          description: Einträge pro Seite, max. 100
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 30
      responses:
        '200':
          description: Eine Seite Chats
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ChatPage'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '503':
          $ref: '#/components/responses/BackendUnavailable'
components:
  schemas:
    ChatPage:
      type: object
      required:
        - chats
        - pagination
      properties:
        chats:
          type: array
          items:
            $ref: '#/components/schemas/ChatSummary'
        pagination:
          type: object
          required:
            - page
            - pageSize
            - pageCount
            - total
          properties:
            page:
              type: integer
              example: 1
            pageSize:
              type: integer
              example: 30
            pageCount:
              type: integer
              example: 4
            total:
              type: integer
              example: 97
    ChatSummary:
      type: object
      required:
        - id
        - title
        - promptId
        - createdAt
        - updatedAt
        - lastActivityAt
      properties:
        id:
          type: string
          example: Q7xk2mVb9pLw
        title:
          type:
            - string
            - 'null'
          example: Wochenrückblick Verkäufe
        promptId:
          type:
            - string
            - 'null'
          description: Prompt, aus dem der Chat gestartet wurde
          example: ab12cd34ef56gh78ij90klmn
        createdAt:
          type: string
          format: date-time
          example: '2026-09-17T08:12:44.000Z'
        updatedAt:
          type: string
          format: date-time
          example: '2026-09-17T08:13:20.000Z'
        lastActivityAt:
          type: string
          format: date-time
          example: '2026-09-17T08:13:20.000Z'
    Error:
      type: object
      required:
        - message
      properties:
        code:
          type: string
          description: >-
            Fehlercode. Fehlt bei den beiden Antworten der Auth-Schicht
            (`Invalid API token`, `Product backend unavailable`).
          example: chat_not_found
        message:
          type: string
          example: Chat not found
  responses:
    Unauthorized:
      description: >-
        Kein oder ungültiges Token. `Invalid API token`: abgelaufen oder
        widerrufen, neues Token holen.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            message: Invalid API token
    Forbidden:
      description: '`forbidden`: Der Assistent ist für diesen Nutzer nicht freigeschaltet'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            code: forbidden
            message: The AI assistant is not enabled for this user
    BackendUnavailable:
      description: Backend vorübergehend nicht erreichbar. Request wiederholen.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            message: Product backend unavailable
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Access Token des Nutzers aus der Delicious Data App (Einstellungen →
        Benutzerkonto → API-Token). Gilt bis zu sechs Tage, endet mit dem
        Logout.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.