> For the complete documentation index, see [llms.txt](https://www.center.daxium-air.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.center.daxium-air.com/api-reference/doc-api/groupes.md).

# Groupes

Gérer les groupes d'un vertical métier

## GET /{app\_short}/groups

> Lister les groupes d'un vertical métier

```json
{"openapi":"3.0.0","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"groups"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"oauth2":{}}],"components":{"securitySchemes":{"oauth2":{"type":"oauth2","description":"Envoyez l'access token sous la forme `Authorization: Bearer <token>`.","flows":{"password":{"tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}},"authorizationCode":{"authorizationUrl":"/oauth/v2/auth","tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}}}}},"parameters":{"XAcceptVersion":{"name":"X-Accept-Version","in":"header","description":"Version de l'API à appliquer. Vaut `v1.0` si omise ; une valeur inconnue bascule sur la version la plus récente.","required":false,"schema":{"type":"string","default":"v1.3","enum":["v1.0","v1.1","v1.2","v1.3"]}}},"schemas":{"Group":{"description":"Groupe d'un vertical métier","properties":{"description":{"description":"Description renseignée par l'administrateur","type":"string"},"id":{"description":"Identifiant du groupe","type":"integer"},"is_system":{"description":"Indique s'il s'agit d'un groupe système","type":"boolean"},"name":{"description":"Nom affiché","type":"string"},"structure_ids":{"description":"Identifiants des formulaires liés au groupe. Calculés uniquement lors de la création ou de la mise à jour d'un groupe ; toujours un tableau vide sur l'endpoint de liste (`GET /groups` ne les renseigne jamais).","type":"array","items":{"type":"integer"}},"user_ids":{"description":"Identifiants des utilisateurs du groupe. Calculés uniquement lors de la création ou de la mise à jour d'un groupe ; toujours un tableau vide sur l'endpoint de liste (`GET /groups` ne les renseigne jamais).","type":"array","items":{"type":"integer"}}},"type":"object"},"ErrorResponse":{"description":"Corps d'erreur standardisé retourné par le subscriber d'exceptions REST.","properties":{"code":{"description":"Code d'erreur Daxium.","type":"string"},"message":{"type":"string"},"url":{"description":"Lien vers le code d'erreur dans la référence des erreurs.","type":"string"},"api_version":{"type":"string"},"infos":{"description":"Contexte additionnel sur l'erreur, lorsque l'exception en porte.","type":"array","items":{}},"server_time":{"type":"integer"}},"type":"object"}},"responses":{"Unauthorized":{"description":"Access token manquant ou invalide.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/{app_short}/groups":{"get":{"tags":["groups"],"summary":"Lister les groupes d'un vertical métier","operationId":"listGroups","parameters":[{"name":"page","in":"query","description":"Page de la vue d'ensemble.","required":false,"allowEmptyValue":false,"schema":{"type":"string","default":"0","pattern":"\\d+"}},{"name":"per_page","in":"query","description":"Nombre de résultats par page (max. 100)","required":false,"allowEmptyValue":false,"schema":{"type":"string","default":"10","pattern":"-?\\d+"}},{"name":"include_system","in":"query","description":"Inclure les groupes système","required":false,"allowEmptyValue":true,"schema":{"type":"string","default":"false"}},{"name":"app_short","in":"path","description":"Nom court du vertical métier, tel qu'il apparaît dans l'URL du back-office.","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/XAcceptVersion"}],"responses":{"200":{"description":"Liste paginée des groupes","content":{"application/json":{"schema":{"properties":{"groups":{"type":"array","items":{"$ref":"#/components/schemas/Group"}},"total_count":{"type":"integer"},"total_pages":{"type":"integer"},"server_time":{"type":"integer"}},"type":"object"}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}}}}
```

## POST /{app\_short}/group

> Créer un groupe

```json
{"openapi":"3.0.0","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"groups"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"oauth2":{}}],"components":{"securitySchemes":{"oauth2":{"type":"oauth2","description":"Envoyez l'access token sous la forme `Authorization: Bearer <token>`.","flows":{"password":{"tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}},"authorizationCode":{"authorizationUrl":"/oauth/v2/auth","tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}}}}},"parameters":{"XAcceptVersion":{"name":"X-Accept-Version","in":"header","description":"Version de l'API à appliquer. Vaut `v1.0` si omise ; une valeur inconnue bascule sur la version la plus récente.","required":false,"schema":{"type":"string","default":"v1.3","enum":["v1.0","v1.1","v1.2","v1.3"]}}},"schemas":{"GroupInput":{"description":"Corps de création ou de mise à jour d'un groupe","required":["name","description"],"properties":{"description":{"description":"Description du groupe","type":"string"},"name":{"description":"Nom du groupe","type":"string"},"structure_ids":{"description":"Identifiants des formulaires du groupe","type":"array","items":{"type":"integer"}},"user_ids":{"description":"Identifiants des utilisateurs du groupe","type":"array","items":{"type":"integer"}}},"type":"object"},"Group":{"description":"Groupe d'un vertical métier","properties":{"description":{"description":"Description renseignée par l'administrateur","type":"string"},"id":{"description":"Identifiant du groupe","type":"integer"},"is_system":{"description":"Indique s'il s'agit d'un groupe système","type":"boolean"},"name":{"description":"Nom affiché","type":"string"},"structure_ids":{"description":"Identifiants des formulaires liés au groupe. Calculés uniquement lors de la création ou de la mise à jour d'un groupe ; toujours un tableau vide sur l'endpoint de liste (`GET /groups` ne les renseigne jamais).","type":"array","items":{"type":"integer"}},"user_ids":{"description":"Identifiants des utilisateurs du groupe. Calculés uniquement lors de la création ou de la mise à jour d'un groupe ; toujours un tableau vide sur l'endpoint de liste (`GET /groups` ne les renseigne jamais).","type":"array","items":{"type":"integer"}}},"type":"object"},"ErrorResponse":{"description":"Corps d'erreur standardisé retourné par le subscriber d'exceptions REST.","properties":{"code":{"description":"Code d'erreur Daxium.","type":"string"},"message":{"type":"string"},"url":{"description":"Lien vers le code d'erreur dans la référence des erreurs.","type":"string"},"api_version":{"type":"string"},"infos":{"description":"Contexte additionnel sur l'erreur, lorsque l'exception en porte.","type":"array","items":{}},"server_time":{"type":"integer"}},"type":"object"}},"responses":{"Unauthorized":{"description":"Access token manquant ou invalide.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/{app_short}/group":{"post":{"tags":["groups"],"summary":"Créer un groupe","operationId":"createGroup","parameters":[{"name":"app_short","in":"path","description":"Nom court du vertical métier, tel qu'il apparaît dans l'URL du back-office.","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/XAcceptVersion"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupInput"}}}},"responses":{"200":{"description":"Groupe créé","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Group"}}}},"400":{"description":"Le corps de la requête est invalide.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}}}}
```

## PUT /{app\_short}/group/{group\_id}

> Mettre à jour un groupe

```json
{"openapi":"3.0.0","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"groups"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"oauth2":{}}],"components":{"securitySchemes":{"oauth2":{"type":"oauth2","description":"Envoyez l'access token sous la forme `Authorization: Bearer <token>`.","flows":{"password":{"tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}},"authorizationCode":{"authorizationUrl":"/oauth/v2/auth","tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}}}}},"parameters":{"XAcceptVersion":{"name":"X-Accept-Version","in":"header","description":"Version de l'API à appliquer. Vaut `v1.0` si omise ; une valeur inconnue bascule sur la version la plus récente.","required":false,"schema":{"type":"string","default":"v1.3","enum":["v1.0","v1.1","v1.2","v1.3"]}}},"schemas":{"GroupInput":{"description":"Corps de création ou de mise à jour d'un groupe","required":["name","description"],"properties":{"description":{"description":"Description du groupe","type":"string"},"name":{"description":"Nom du groupe","type":"string"},"structure_ids":{"description":"Identifiants des formulaires du groupe","type":"array","items":{"type":"integer"}},"user_ids":{"description":"Identifiants des utilisateurs du groupe","type":"array","items":{"type":"integer"}}},"type":"object"},"Group":{"description":"Groupe d'un vertical métier","properties":{"description":{"description":"Description renseignée par l'administrateur","type":"string"},"id":{"description":"Identifiant du groupe","type":"integer"},"is_system":{"description":"Indique s'il s'agit d'un groupe système","type":"boolean"},"name":{"description":"Nom affiché","type":"string"},"structure_ids":{"description":"Identifiants des formulaires liés au groupe. Calculés uniquement lors de la création ou de la mise à jour d'un groupe ; toujours un tableau vide sur l'endpoint de liste (`GET /groups` ne les renseigne jamais).","type":"array","items":{"type":"integer"}},"user_ids":{"description":"Identifiants des utilisateurs du groupe. Calculés uniquement lors de la création ou de la mise à jour d'un groupe ; toujours un tableau vide sur l'endpoint de liste (`GET /groups` ne les renseigne jamais).","type":"array","items":{"type":"integer"}}},"type":"object"},"ErrorResponse":{"description":"Corps d'erreur standardisé retourné par le subscriber d'exceptions REST.","properties":{"code":{"description":"Code d'erreur Daxium.","type":"string"},"message":{"type":"string"},"url":{"description":"Lien vers le code d'erreur dans la référence des erreurs.","type":"string"},"api_version":{"type":"string"},"infos":{"description":"Contexte additionnel sur l'erreur, lorsque l'exception en porte.","type":"array","items":{}},"server_time":{"type":"integer"}},"type":"object"}},"responses":{"Unauthorized":{"description":"Access token manquant ou invalide.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/{app_short}/group/{group_id}":{"put":{"tags":["groups"],"summary":"Mettre à jour un groupe","operationId":"updateGroup","parameters":[{"name":"app_short","in":"path","description":"Nom court du vertical métier, tel qu'il apparaît dans l'URL du back-office.","required":true,"schema":{"type":"string"}},{"name":"group_id","in":"path","required":true,"schema":{"type":"string","pattern":"\\d+"}},{"$ref":"#/components/parameters/XAcceptVersion"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupInput"}}}},"responses":{"200":{"description":"Groupe mis à jour","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Group"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"description":"Aucun groupe avec cet identifiant dans le vertical métier.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://www.center.daxium-air.com/api-reference/doc-api/groupes.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.