# Introduction
URL: https://docs.fluenta.io/en/docs

What the API gives you, which credential it takes and where to start.



The Fluenta API gives you over HTTP what you see in the dashboard: the plant,
the «Programa» (each module's production queue), the boards and the reports
of the organizations you belong to, with the same figures. It is for your own programs and for AI apps.

Every route hangs from one base URL:

```
https://api.fluenta.io/v1/external
```

## Worth knowing before you start [#worth-knowing-before-you-start]

* **Two credentials.** An API token, which you create in «Configuración»
  (Settings) → «Tokens de API» (API tokens) and works on the Light and Pro
  plans, or a connection, which is an AI app authorized through «Conectar con
  IA» (Connect with AI) and needs Pro. Both travel in the `Authorization`
  header. More in [Authentication](./authentication.mdx).
* **You act as yourself.** Every call uses the role you have in the dashboard,
  read again on each request, and names the organization in the path. More in
  [Organizations](./organizations.mdx).
* **The plan decides.** The API gives each organization what its plan gives it
  in the dashboard. More in [Plans](./plans.mdx).
* **Permissions.** `read` («Leer», Read) is always granted. `program`
  («Gestionar el Programa», Manage the Programa) is needed to write to the
  «Programa» and to the reference catalogue. More in
  [Permissions](./permissions.mdx).
* **Errors.** Every error response has the shape
  `{ statusCode, code, message }`. Branch on `code`. More in
  [Errors](./errors.mdx).

## Where to start [#where-to-start]

<Cards>
  <Card title="Quickstart" href="/en/docs/quickstart">
    Create an API token and make your first request.
  </Card>

  <Card title="Reference" href="/en/docs/reference">
    One page per operation, generated from the OpenAPI document.
  </Card>

  <Card title="Using the API from an AI" href="/en/docs/ai">
    The index in llms.txt, every page as Markdown and the OpenAPI document.
  </Card>
</Cards>

The whole OpenAPI document is at [`/openapi.json`](/openapi.json), and the
index for agents at [`/llms.txt`](/llms.txt).