# Vorschau auf die öffentliche API von aqua

Um die Stabilität zu verbessern und Ihre Automatisierungsabläufe zukunftssicher zu machen, werden wir in einigen Monaten eine neue öffentliche API einführen.

\
Diese neue API wird neben der aktuellen internen API bestehen, ist jedoch so konzipiert, dass sie eine größere Stabilität bietet und in Zukunft unsere empfohlene Schnittstelle für externe Integrationen sein wird, da sich die interne API ohne Vorankündigung ändern kann.

## Das kommt auf uns zu:

* 🧾 **Die vorläufige Dokumentation** steht für Sie bereit, sodass Sie alle verfügbaren Endpunkte prüfen und mit Ihrer aktuellen Nutzung vergleichen können. Bitte laden Sie die Datei unten herunter.
* 🔐 **Die Autorisierung ändert sich**. In Zukunft müssen Sie für jede Anfrage den Authorization-Header mit dem Bearer-Token verwenden. Weitere Details werden in Kürze in der vollständigen Dokumentation folgen.
* **🧪 Testumgebung.** Wir bereiten eine spezielle Testumgebung für die neue API vor. Dort können Sie Ihre Implementierung überprüfen, bevor sie in Betrieb genommen wird. Wir werden Sie benachrichtigen, sobald die Umgebung fertig ist.

**Bitte laden Sie das Dokument mit der öffentlichen API herunter und prüfen Sie es:**

{% file src="/files/foZSWNXFvZKd8HNEG7kX" %}

{% hint style="warning" %}
**What’s next?**

**To make sure everything continues to run smoothly, we encourage you to review the documentation and share your questions or feedback by&#x20;**<mark style="color:red;">**June 23, 2025**</mark>**. This gives us time to make any needed adjustments before the official release.**
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aqua-cloud.io/documentation/de-documentation/aqua-news/vorschau-auf-die-offentliche-api-von-aqua.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.