{{indexmenu_n>10}}

## Utiliser l'API de Mattermost

Pour la plupart des opérations, on préfère utiliser l'outil `mmctl` présenté sur [[technique:adminserv:mattermost:admin|cette page]].

L'API peut néanmoins être utilisée pour ces mêmes opérations (et vraiment pour le moindre détail). En pratique, puisque celle-ci nécessite d'envoyer des requêtes HTTP "à la main", on l'utilise surtout dans les [scripts d'administration de Mattermost](https://gitlab.utc.fr/picasoft/projets/mattermost-scripts-admin).

La documentation de l'API est accessible [[https://api.mattermost.com|sur le site de Mattermost]].

Néanmoins, si on tient à l'utiliser en ligne de commande, on peut générer un jeton d'accès personnel comme vu sur [[technique:adminserv:mattermost:admin|cette page]], puis utiliser ce jeton pour faire des requêtes. 
Exemple pour lister les équipes visibles par l'utilisateur ayant créé le jeton :

```bash
curl -i -H "Authorization: Bearer <token>" https://team.picasoft.net/api/v4/teams
```