# Ajouter ou supprimer un label

Les instructeurs peuvent ajouter (ou modifier) des labels à un dossier, qui agissent comme une sorte d’étiquette personnalisée. La liste des labels disponibles est au préalable définie dans l'interface l'administrateur (pas encore par API), ainsi que l’ordre dans lequel ils sont retournés.

Par défaut 5 labels sont créés : *Urgent, À examiner, À relancer, Complet, À signer*. Laissez libre court à votre imagination pour organiser l’instruction: *Prêt pour la commission, Validé par la hiérarchie*, …

L’API permet d’associer ou supprimer un label à un dossier. Récupérez d'abord [la liste des identifiants de labels disponibles](/api-graphql/les-queries/getdemarche.md#query-pour-recuperer-les-informations-dune-demarche) sur la démarche.

Il n’y a pas de limite sur le nombre de labels par dossier, mais dans l’interface **demarche.numerique.gouv.fr** il n’est généralement pas pratique d’en afficher plus de 5 ou 6 par dossier.

#### Query

### Ajouter un label

```graphql
mutation dossierAjouterLabel($input: DossierAjouterLabelInput!) {
	dossierAjouterLabel(input: $input) {
		dossier {
			id
			labels {
				id
				name
				color
			}
		}
		label {
			name
		}
		errors {
			message
		}
	}
}

```

#### Variables

```graphql
{
  "query": <query>,
  "operationName": "dossierAjouterLabel",
  "variables": {
    "input": {
      "dossierId": "UHJvY4VkdXKlLTI5NTgw",
      "labelId": "TGFiZWwtMzA0MzQw"
    }
  }
}
```

{% hint style="info" %}
L’attribut `color` est un `string` parmi quelques noms de couleurs disponibles dans le Design Système de l'État. Il sera peut-être inutile dans le contexte de votre utilisation de l'API.
{% endhint %}

### Supprimer un label

#### Query

```graphql
mutation dossierSupprimerLabel($input: DossierSupprimerLabelInput!) {
	dossierSupprimerLabel(input: $input) {
		dossier {
			id
			labels { # Le ou les labels restant sur le dossier
				id
				name
				color
			}
		}
		label {
			name # Le label supprimé
		}
		errors {
			message
		}
	}
}

```

#### Variables

```graphql
{
  "query": <query>,
  "operationName": "dossierSupprimerLabel",
  "variables": {
    "input": {
      "dossierId": "UHJvY4VkdXKlLTI5NTgw",
      "labelId": "TGFiZWwtMzA0MzQw"
    }
  }
}
```


---

# Agent Instructions: 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:

```
GET https://doc.demarche.numerique.gouv.fr/api-graphql/les-mutations/ajouter-ou-supprimer-un-label.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.