# 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="/files/foZSWNXFvZKd8HNEG7kX" %}
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 %}


---

# 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/product-updates-for-public-and-private-clouds-customers/aqua-news/preview-of-aquas-public-api.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.