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

# Übersicht

> Read-only Ticket- und Nachrichten-API für Integrationen und KI-Agenten-Tools.

Die Chatarmin CX Public API v1 ermöglicht dir, Tickets, gespeicherte Posteingang-Ansichten und Konversationsverläufe programmatisch aus deinem Workspace zu lesen. Nutze sie für eigene Dashboards, Data-Warehouse-Syncs oder KI-Agenten mit Live-Support-Kontext.

## Was v1 enthält

| Funktion                                                 | Endpoint                                        |
| -------------------------------------------------------- | ----------------------------------------------- |
| Tickets auflisten (Cursor-Pagination, optionale Ansicht) | `GET /public/v1/tickets`                        |
| Einzelnes Ticket per Nummer abrufen                      | `GET /public/v1/tickets/:ticketNumber`          |
| Konversationsnachrichten lesen                           | `GET /public/v1/tickets/:ticketNumber/messages` |
| Gespeicherte Posteingang-Ansichten auflisten             | `GET /public/v1/views`                          |
| Health Check                                             | `GET /public/v1/health`                         |

Basis-URL: `https://api.armin.cx/public/v1`

## Was v1 nicht enthält

v1 ist **nur lesend**. Tickets erstellen, Kunden antworten, CSV/Excel-Export und Analytics bleiben auf der Legacy-Oberfläche `/public/*`, bis eine spätere Version kommt.

Du kannst Tickets nicht mit Ad-hoc-Query-Parametern filtern (Status, Kanal, Datumsbereich, Volltextsuche). Lege Filter in einer [gespeicherten Posteingang-Ansicht](/de/inbox/views-and-filters) an und übergib `view_id`.

## Dokumentationsübersicht

<CardGroup cols={2}>
  <Card title="Erste Schritte" icon="rocket" href="/de/api/getting-started">
    API-Schlüssel erstellen und ersten Request senden.
  </Card>

  <Card title="Agent-Tool-Beispiele" icon="robot" href="/de/api/agent-tool-examples">
    Typische Agenten-Aufgaben auf API-Aufrufe mappen.
  </Card>

  <Card title="Authentifizierung" icon="key" href="/de/api/authentication">
    API-Schlüssel, Scopes und Least-Privilege-Setup.
  </Card>

  <Card title="OpenAPI-Referenz" icon="book" href="https://api.armin.cx/docs/v1">
    Interaktive Scalar-Docs mit Request-/Response-Schemas.
  </Card>
</CardGroup>

## Lesekonsistenz

Public v1 liest von der Read-Replica. Antworten können unter hoher Schreiblast einige Sekunden hinter der Posteingang-Oberfläche liegen. Für Agenten-Tools nach Kundennachrichten: kurzes Backoff statt enger Polling-Schleifen.