> ## 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.

# Erste Schritte

> API-Schlüssel erstellen und ersten Public API v1 Request senden.

In wenigen Minuten vom Nullpunkt zum funktionierenden API-Aufruf.

## Voraussetzungen

* Chatarmin-CX-Workspace mit Berechtigung für API-Schlüssel (**Einstellungen → API**)
* `curl` oder ein anderer HTTP-Client (z. B. Postman)

## Schritt 1 — API-Schlüssel erstellen

<Steps>
  <Step title="API-Einstellungen öffnen">
    Im Dashboard: [Einstellungen → API](https://armin.cx/app/_/settings/api).
  </Step>

  <Step title="Schlüssel anlegen">
    Klicke **API-Schlüssel erstellen**, vergib einen Namen und wähle Scopes. Für reine Lese-Integrationen und KI-Agenten reicht **`tickets:read`**.
  </Step>

  <Step title="Schlüssel kopieren">
    Kopiere den Schlüssel und speichere ihn in einem Secrets Manager, nicht im Quellcode.
  </Step>
</Steps>

Details zu Scopes und Rotation: [Authentifizierung & API-Schlüssel](/de/api/authentication).

## Schritt 2 — Verbindung prüfen

```bash theme={null}
curl -sS \
  -H "cx-api-key: DEIN_API_SCHLÜSSEL" \
  "https://api.armin.cx/public/v1/health"
```

Erwartete Antwort:

```json theme={null}
{
  "success": true,
  "data": {
    "version": "v1"
  }
}
```

Der Health-Endpoint braucht einen gültigen Schlüssel, aber keinen bestimmten Scope — gut, um die Auth zu testen, bevor du Ticket-Routen aufrufst.

## Schritt 3 — Tickets auflisten

```bash theme={null}
curl -sS \
  -H "cx-api-key: DEIN_API_SCHLÜSSEL" \
  "https://api.armin.cx/public/v1/tickets?limit=5"
```

Jede v1-Erfolgsantwort nutzt das Envelope `{ "success": true, "data": ... }`. Listen liefern zusätzlich `pagination`:

```json theme={null}
{
  "success": true,
  "data": [ ... ],
  "pagination": {
    "has_more": true,
    "next_cursor": "2026-07-20T10:00:00.000Z|019b..."
  }
}
```

Übergib `pagination.next_cursor` als Query-Parameter `cursor` für die nächste Seite. Siehe [Pagination](/de/api/pagination).

## Schritt 4 — Gespeicherte Ansichten erkunden

Die meisten Agent-Workflows starten mit gespeicherten Posteingang-Ansichten:

```bash theme={null}
curl -sS \
  -H "cx-api-key: DEIN_API_SCHLÜSSEL" \
  "https://api.armin.cx/public/v1/views"
```

Wähle eine View-`id`, dann Tickets mit dieser Ansicht:

```bash theme={null}
curl -sS \
  -H "cx-api-key: DEIN_API_SCHLÜSSEL" \
  "https://api.armin.cx/public/v1/tickets?view_id=VIEW_UUID&limit=40"
```

Vollständiger Workflow: [Filtern & gespeicherte Ansichten](/de/api/filtering-and-saved-views).

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="OpenAPI-Referenz" icon="book" href="https://api.armin.cx/docs/v1">
    Vollständige Endpoint-Referenz mit Schemas und Try it.
  </Card>

  <Card title="Agent-Tool-Beispiele" icon="robot" href="/de/api/agent-tool-examples">
    Typische KI-Agenten-Muster als API-Aufrufe.
  </Card>
</CardGroup>