# Lister les agendas

> Liste les agendas connectés à votre espace de travail, qu'un réceptionniste réserve dessus ou non. Chaque id est la clé attendue par la map…

`GET /v2/api/calendars`

<Note>
**Scope requis :** `AGENTS_READ`
</Note>

## Comportement

Liste les agendas connectés à votre espace de travail, qu'un réceptionniste réserve dessus ou non. Chaque `id` est la clé attendue par la map `scheduling.calendars` de [Modifier la configuration](/fr/docs/agent/update-agent).

La liste n'est pas paginée : elle est bornée par votre équipe, pas par l'usage.

## Ce que vous voyez

La visibilité suit la même règle que l'app Allo. Un admin voit tous les agendas de l'espace de travail, un membre uniquement ceux qu'il a connectés lui-même. `owner.is_current_user` indique lesquels.

Connecter un agenda est un flux OAuth, réalisé dans l'app Allo. Cet endpoint liste ce qui est déjà connecté.

## Types d'événement

Les types d'événement ne figurent pas dans cette réponse : les lire coûte un aller-retour vers le fournisseur par agenda. Récupérez-les agenda par agenda avec [Lire un agenda](/fr/docs/agent/get-calendar).

## Erreurs

- `403 API_KEY_INSUFFICIENT_SCOPE` : la clé ne porte pas le scope `AGENTS_READ`.
