# Preview of aqua's public API

To improve the stability and future-proof your automation workflows, in **Q1 2026** we are introducing a new public API. 

This new API will coexist with the current internal one, but is designed to offer greater stability and will be our recommended interface for external integrations going forward, <mark style="background-color:blue;">**as the internal API may change without notice.**</mark>

#### Here’s what’s coming:

* 🧾 **Preliminary documentation is ready for you to explore**, so you can review all available endpoints and compare them to your current usage. Please download the file below.
* 🔐 **Authorization is changing.**  In future, for each request, you’ll now need to use the Authorization header with the Bearer token. More details will follow soon in the full documentation.
* **🧪 Test environment.** We’re preparing a dedicated test environment for the new API. You’ll be able to validate your implementation before it goes live. We’ll notify you as soon as it’s ready.

<mark style="background-color:yellow;">**Please download and review the document with public API**</mark>

{% file src="<https://3920520305-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyZbW8vbNs5hz8x57emJJ%2Fuploads%2Flc6qdAlkwSzkwHOe3tR8%2Faqua-public-swagger.json?alt=media&token=7cf87950-9ca0-4be2-9d12-95498d22c3fa>" %}
aqua public API
{% endfile %}

**What’s next?**

{% hint style="warning" %}

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

{% endhint %}