> For the complete documentation index, see [llms.txt](https://docs.digitalapi.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digitalapi.ai/api-gateway/introduction.md).

# Introduction

AILIX is an enterprise API gateway and developer platform. The data plane sits in front of your backend services and enforces routing, authentication, rate-limiting, transformation, and observability policy. The Helix Portal is the control plane you use every day.

{% hint style="info" %}
**Who this guide is for.** You are the engineer who runs the API gateway: you operate production traffic, manage backend pools, configure routing and traffic policy, attach plugins, issue and rotate credentials for external consumers, and read the dashboards during a release. This guide covers the mechanics of doing that work in AILIX; it does not re-explain gateway concepts you already know.
{% endhint %}

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>API Gateway</strong></td><td>Services, upstreams, routes, plugins, and environments. The core traffic-management surface.</td><td><a href="/pages/f4WCBpW0BxOTjD8L7D1A">/pages/f4WCBpW0BxOTjD8L7D1A</a></td></tr><tr><td><strong>Observability</strong></td><td>Custom widgets, request traces, and custom reports for live traffic.</td><td><a href="/pages/ManEBvZUdPv8GfDDQWzu">/pages/ManEBvZUdPv8GfDDQWzu</a></td></tr><tr><td><strong>Developer Portal</strong></td><td>The consumer experience and API distribution, documented as a separate product.</td><td><a href="https://docs.digitalapi.ai/developer-portal">https://docs.digitalapi.ai/developer-portal</a></td></tr><tr><td><strong>Setup</strong></td><td>Organisation, users, groups, roles, and identity-provider connections.</td><td><a href="/pages/S1eoedB5gFl4b4pjVWh0">/pages/S1eoedB5gFl4b4pjVWh0</a></td></tr></tbody></table>

## Get started

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Getting started</strong></td><td>Sign in, learn the portal layout, and walk the first-day path.</td><td><a href="/pages/xqfniZ96SNYe6AnRmal6">/pages/xqfniZ96SNYe6AnRmal6</a></td></tr><tr><td><strong>Defining services</strong></td><td>Create a service and bind it to a backend.</td><td><a href="/pages/f4WCBpW0BxOTjD8L7D1A">/pages/f4WCBpW0BxOTjD8L7D1A</a></td></tr><tr><td><strong>Configuring upstreams</strong></td><td>Define backend pools with health checks and load balancing.</td><td><a href="/pages/RMFKwtbfvHL1AGZoNLpS">/pages/RMFKwtbfvHL1AGZoNLpS</a></td></tr><tr><td><strong>Browsing the plugin catalogue</strong></td><td>Find and understand the plugins you can attach.</td><td><a href="/pages/GpJDYKn3ph2ZgZqxfP4a">/pages/GpJDYKn3ph2ZgZqxfP4a</a></td></tr></tbody></table>

## Core features

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Working with environments</strong></td><td>Promote services and rotate credentials across environments.</td><td><a href="/pages/OiMMEZn91xp6oXtqLHqo">/pages/OiMMEZn91xp6oXtqLHqo</a></td></tr><tr><td><strong>Building custom widgets</strong></td><td>Build named widgets for the metrics you watch every day.</td><td><a href="/pages/ManEBvZUdPv8GfDDQWzu">/pages/ManEBvZUdPv8GfDDQWzu</a></td></tr><tr><td><strong>Investigating with request traces</strong></td><td>Drill from a data point into the end-to-end timing of a single request.</td><td><a href="/pages/yirEHMus2sizXETTCHIm">/pages/yirEHMus2sizXETTCHIm</a></td></tr><tr><td><strong>Plugin reference</strong></td><td>Every plugin by category, with priority and configuration fields.</td><td><a href="/pages/3ilLKnAW8bBri2avzZwY">/pages/3ilLKnAW8bBri2avzZwY</a></td></tr></tbody></table>

## Administer and operate

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>API Gateway</strong></td><td>Define services, configure upstreams, attach plugins, and bind environments.</td><td><a href="/pages/f4WCBpW0BxOTjD8L7D1A">/pages/f4WCBpW0BxOTjD8L7D1A</a></td></tr><tr><td><strong>Developer Portal</strong></td><td>The consumer experience and API distribution, documented as a separate product.</td><td><a href="https://docs.digitalapi.ai/developer-portal">https://docs.digitalapi.ai/developer-portal</a></td></tr><tr><td><strong>Managing your organisation</strong></td><td>Users, groups, roles, and identity-provider connections.</td><td><a href="/pages/S1eoedB5gFl4b4pjVWh0">/pages/S1eoedB5gFl4b4pjVWh0</a></td></tr><tr><td><strong>Troubleshooting and FAQs</strong></td><td>Symptom-cause-fix lookups and common onboarding questions.</td><td><a href="/pages/y2YBGjqY3axQYHpZ9LWE">/pages/y2YBGjqY3axQYHpZ9LWE</a></td></tr></tbody></table>

{% hint style="success" %}
**New here?** Start with [Getting started](/api-gateway/getting-started.md) to sign in and learn the portal layout, then follow the first-day path to put one API in front of one consumer. For what AILIX is, its capabilities, and deployment models, read the [Overview](/api-gateway/overview.md).
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.digitalapi.ai/api-gateway/introduction.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.