> ## Documentation Index
> Fetch the complete documentation index at: https://www.octoparse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Définir la rétention

> Active ou retire le flag de rétention d’un dataset que vous possédez.

**`PUT`** `https://api-datahub.octoparse.com/v1/datasets/{dataset_id}/retention`

Authentification : clé API requise (`Authorization: Bearer <API Key>`).

Les résultats d’exécution sont conservés 90 jours à compter de la création par défaut. Les datasets avec le flag de rétention sont exclus du nettoyage d’expiration. Le flag est une déclaration explicite de l’utilisateur : la lecture ne renouvelle pas la rétention, et activer/retirer sont idempotents.

Vous ne pouvez marquer que vos propres datasets. Le dataset d’autrui, un dataset seed public ou un id manquant renvoient tous `404`. La porte de marquage est plus étroite que la porte de visibilité car les seed ne sont pas votre sortie et ne sont pas nettoyés, donc les marquer n’a pas de sens.

## Requête

### Paramètres de chemin

<ParamField path="dataset_id" type="string" required>
  Id du dataset.
</ParamField>

### Corps de la requête

<ParamField body="retained" type="boolean" required>
  `true` pour retenir, `false` pour retirer le flag.
</ParamField>

### Exemple de requête

```bash theme={null}
curl -X PUT \
  -H "Authorization: Bearer $OCTOPARSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"retained": true}' \
  "https://api-datahub.octoparse.com/v1/datasets/ds_0bd5345d13d0/retention"
```

## Réponse

### 200 succès

```json theme={null}
{
  "data": {
    "dataset_id": "ds_0bd5345d13d0",
    "retained": true
  }
}
```

### Erreurs

| HTTP | `code`              | `category`  | Description                                                             |
| ---- | ------------------- | ----------- | ----------------------------------------------------------------------- |
| 401  | `unauthorized`      | `forbidden` | Clé API manquante ou invalide.                                          |
| 404  | `dataset-not-found` | `not_found` | Le dataset n’existe pas, n’est pas le vôtre ou ne peut pas être marqué. |

Les réponses d’erreur utilisent `{"error": {code, category, message, retryable}}`. Voir <a href="/docs/fr/datahub/api/reference/introduction#errors">Erreurs</a>.

## Bibliothèques clientes

<CodeGroup>
  ```python Python theme={null}
  client.set_dataset_retention("ds_0bd5345d13d0", True)
  ```

  ```js JavaScript theme={null}
  await client.setDatasetRetention("ds_0bd5345d13d0", true);
  ```
</CodeGroup>