> ## 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.

# Mettre à jour les paramètres

> Changer la portée de visibilité, l’interrupteur de maintenance et la locale source. Entièrement réversible.

**`PATCH`** `https://api-datahub.octoparse.com/v1/data-apps/{app_id}/settings`

Authentification : clé API requise (`Authorization: Bearer <API Key>`). Auteur de l’app uniquement ; les autres reçoivent `404`.

État ops réversible au niveau app, orthogonal au cycle de vie — ajustable à tout moment :

• `scope` : `public` visible sur le market / `private` auteur seulement / `shared` liste de grants (maintenez-la via les endpoints de grant).

* `accepting_runs` : interrupteur de maintenance. `false` signifie en maintenance ; les nouvelles exécutions d’autrui sont refusées avec `403`, mais l’auteur peut continuer à s’auto-tester sans restriction. Un message optionnel s’affiche aux appelants.
* `source_locale` : langue du texte du manifest (par ex. `zh-CN` / `en-US`). Non défini → défaut du déploiement. Les overlays de traduction s’indexent par rapport à cette locale.

Les apps sans aucune release peuvent aussi être mises à jour.

## Requête

### Paramètres de chemin

<ParamField path="app_id" type="string" required>
  Référence d’app.
</ParamField>

### Corps de la requête

<ParamField body="scope" type="enum">
  Portée de visibilité : `public` / `private` / `shared`.

  Valeurs autorisées : `public` / `private` / `shared`.
</ParamField>

<ParamField body="accepting_runs" type="boolean">
  S’il faut accepter de nouvelles exécutions d’autrui.
</ParamField>

<ParamField body="pause_message" type="string">
  Message montré aux appelants pendant la maintenance.
</ParamField>

<ParamField body="source_locale" type="string">
  Code de locale source du manifest.
</ParamField>

### Exemple de requête

```bash theme={null}
curl -X PATCH \
  -H "Authorization: Bearer $OCTOPARSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"accepting_runs": false, "pause_message": "Upstream API under maintenance; expected back at 18:00"}' \
  "https://api-datahub.octoparse.com/v1/data-apps/carol/reviews-query/settings"
```

## Réponse

### 200 succès

```json theme={null}
{
  "data": {
    "scope": "private",
    "accepting_runs": true,
    "pause_message": null,
    "source_locale": "zh-CN",
    "warnings": []
  }
}
```

La charge utile est encapsulée dans `data`. Champs :

<ResponseField name="scope" type="string" required>
  Portée de visibilité actuelle.
</ResponseField>

<ResponseField name="accepting_runs" type="boolean" required>
  Interrupteur de maintenance actuel.
</ResponseField>

<ResponseField name="pause_message" type="string">
  Message de maintenance actuel.
</ResponseField>

<ResponseField name="source_locale" type="string" required>
  Locale source actuelle.
</ResponseField>

<ResponseField name="warnings" type="object[]">
  Avertissements structurés.

  <Expandable title="champs">
    <ResponseField name="code" type="string" required>
      —
    </ResponseField>

    <ResponseField name="params" type="object">
      —
    </ResponseField>
  </Expandable>
</ResponseField>

### Erreurs

| HTTP | `code`         | `category`  | Description                    |
| ---- | -------------- | ----------- | ------------------------------ |
| 401  | `unauthorized` | `forbidden` | Clé API manquante ou invalide. |

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

Les SDK Python et JavaScript n’encapsulent pas encore cet endpoint. Appelez REST directement.