> For the complete documentation index, see [llms.txt](https://doc.demarches-simplifiees.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.demarches-simplifiees.fr/api-graphql/les-mutations.md).

# Les mutations

### L'API offre les endpoints suivant en écriture ([mutations](https://demarche.numerique.gouv.fr/graphql)) :

#### Dossier

Pour rappel, les usagers déposent les dossiers, les instructeurs les instruisent. Nous mettons donc a disposition toutes les mutations nécéssaires pour traiter un dossier dans tout son cycle de vie.

Pour rappel, le cycle de vie d'un dossier dans DS est le suivant : brouillon -> en construction -> en instruction -> accepté ou refusé ou classé sans suite.

Les mutations possibles pour un dossier sont les suivantes :

* Passer un dossier en instruction
* Accepter un dossier
* Refuser un dossier
* Classer un dossier sans suite
* Repasser un dossier en construction
* Repasser un dossier en instruction
* Archiver un dossier
* Ajouter un message à la messagerie du dossier / usager
* Changer un dossier de groupe d'instructeur
* Ajouter un label
* Retirer un label

#### Demarche :

Pour rappel, la démarche décrit le formulaire présenté aux usagers, la durée de conservation des données, les instructeurs et groupes d'instructeurs qui instruisent les dossiers déposé sur la démarche.

Les mutations possibles pour une démarche sont les suivantes ([voir le détail et des exemples](/api-graphql/les-mutations/gerer-une-demarche.md)) :

* Publier une démarche
* Modifier les paramètres d'une démarche (titre, description, date limite de dépôt, etc.)
* Cloner une démarche (avec, en option, son service)

#### AnnotationPrivées :

* De modifier une annotation privée (de type checkbox, date, datetime, nombre entier et text)

#### GroupeInstructeur :

* Créer un groupe d'instructeur
* Ajouter un instructeur à un groupe d'instructeur
* Modifier un groupe d'instructeur
* Supprimer un instructeur d'un groupe d'instructeur

#### PieceJointe :

* Uploader un PJ pour la liée à un message envoyé a l'usager


---

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://doc.demarches-simplifiees.fr/api-graphql/les-mutations.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.