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

# Endpoints

> Alle Public API v1 Endpoints, gruppiert nach Ressource, mit vollständigen Schemas in der OpenAPI-Referenz.

Diese Seite ist eine Übersicht aller `/public/v1`-Endpoints. Sie wiederholt keine Parameter, Request-Bodies oder Response-Schemas — die stehen einmal, in der [OpenAPI-Referenz](https://api.armin.cx/docs/v1), wo du jeden Request auch direkt ausprobieren kannst. Nutze die Links unten, um direkt zu einer Ressource zu springen.

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

## Tickets

[In der OpenAPI-Referenz ansehen](https://api.armin.cx/docs/v1#tag/tickets)

| Methode & Pfad | Macht | Scope |
| - | - | - |
| `GET /tickets` | Tickets auflisten, optional gefiltert über eine [gespeicherte Ansicht](/de/api/filtering-and-saved-views) | `tickets:read` |
| `GET /tickets/:ticketNumber` | Einzelnes Ticket per Nummer abrufen | `tickets:read` |
| `GET /tickets/:ticketNumber/messages` | Konversationsverlauf eines Tickets lesen | `tickets:read` |
| [`POST /tickets`](/de/api/create-ticket) | Ticket erstellen | `tickets:write` |
| `POST /tickets/:ticketNumber` | Status, Priorität oder Zuweisung eines Tickets ändern | `tickets:write` |
| [`POST /tickets/:ticketNumber/messages`](/de/api/send-message) | Antwort oder interne Notiz senden | `tickets:write` |

## Attachments

[In der OpenAPI-Referenz ansehen](https://api.armin.cx/docs/v1#tag/attachments)

| Methode & Pfad | Macht | Scope |
| - | - | - |
| `POST /attachments/upload-url` | Signierte URL für einen Datei-Upload anfordern | `tickets:write` |
| `POST /attachments/:attachmentId/confirm` | Upload bestätigen, damit er an ein Ticket angehängt werden kann | `tickets:write` |

## Tags

[In der OpenAPI-Referenz ansehen](https://api.armin.cx/docs/v1#tag/tags)

| Methode & Pfad | Macht | Scope |
| - | - | - |
| `GET /tags` | Tags der Organisation auflisten | `tags:read` |
| `POST /tags` | Tag erstellen | `tags:write` |

## Views

[In der OpenAPI-Referenz ansehen](https://api.armin.cx/docs/v1#tag/views)

| Methode & Pfad | Macht | Scope |
| - | - | - |
| `GET /views` | [Gespeicherte Posteingang-Ansichten](/de/api/filtering-and-saved-views) auflisten | `tickets:read` |

## Teams

[In der OpenAPI-Referenz ansehen](https://api.armin.cx/docs/v1#tag/teams)

| Methode & Pfad | Macht | Scope |
| - | - | - |
| `GET /teams` | Teams auflisten, denen Tickets und Agenten zugewiesen werden können | `teams:read` |

## Agents

[In der OpenAPI-Referenz ansehen](https://api.armin.cx/docs/v1#tag/agents)

| Methode & Pfad | Macht | Scope |
| - | - | - |
| `GET /agents` | Agenten der Organisation auflisten | `agents:read` |

## Reports

[In der OpenAPI-Referenz ansehen](https://api.armin.cx/docs/v1#tag/reports)

Die Abfragesprache und Beispiel-Requests stehen in [Berichte und Metriken](/de/api/reports).

| Methode & Pfad | Macht | Scope |
| - | - | - |
| `GET /reports/metrics` | Metrik-IDs für `POST /reports/query` entdecken | `analytics:read` |
| `POST /reports/query` | Berichtsdaten mit der CX-Abfragesprache abfragen | `analytics:read` |

## Analytics-Exporte

[In der OpenAPI-Referenz ansehen](https://api.armin.cx/docs/v1#tag/analytics-exports)

Benötigte Dashboard-Berechtigungen und Pagination stehen in [CSAT- und Session-Exporte](/de/api/analytics-exports).

| Methode & Pfad | Macht | Scope |
| - | - | - |
| `GET /csat-surveys` | Einzelne CSAT-Umfragen exportieren | `analytics:read` |
| `GET /agent-sessions` | Erfasste Agenten-Login-Intervalle exportieren | `analytics:read` |

## Health

[In der OpenAPI-Referenz ansehen](https://api.armin.cx/docs/v1#tag/health)

| Methode & Pfad | Macht | Scope |
| - | - | - |
| `GET /health` | API-Verfügbarkeit prüfen | Keiner — kein `cx-api-key` nötig |


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