> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arquos.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> L'API publique d'Arquos V2 : brancher votre logiciel sur Arquos, ouvrir des appels de dépannage, et laisser un agent IA travailler dans Arquos.

<Note>
  **Bêta, bientôt disponible.** L'API V2 accompagne la nouvelle version d'Arquos. D'ici sa mise en production, l'API V1 (`/api/1.1/wf/…`, clé `x-api-key`) reste celle de l'application actuelle.
</Note>

L'API V2 sert trois usages :

| Usage | Qui l'appelle | Point d'entrée |
| :- | :- | :- |
| Lire et agir dans Arquos depuis votre logiciel (ERP, outil métier) | Votre logiciel, avec un jeton d'API | `/api/v2/…`, voir [l'API REST](/v2/api-rest) |
| Ouvrir et suivre un appel de dépannage | Un centre d'appels ou de télésurveillance | `POST /api/partners/calls` |
| Lire et agir dans Arquos au nom d'un utilisateur | Un agent IA, par le protocole MCP | `POST /api/mcp` |

L'API V2 répond à `https://api.arquos.eu`, une adresse qui ne changera pas. Les liens `url` des réponses mènent aux écrans de l'application, sur `https://app.arquos.eu`.

Les autres routes de l'application (le web, myArquos), hors `/api/v2`, sont internes : elles peuvent changer sans préavis et ne se documentent pas ici.

## Ce qui change depuis la V1

* **Une clé désigne son agence.** En V1, la requête portait un `agency_id` ; en V2, l'agence se déduit de la clé et ne se passe jamais dans le corps.
* **Un en-tête `Authorization: Bearer`** remplace `x-api-key`.
* **Des refus explicites** : 401, 404, 422, avec un message lisible (voir [Erreurs](/v2/erreurs)).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.