Exchange valt buiten deze API/CLI-release. Eventuele historische Exchange-voorbeelden in deze gids zijn niet beschikbaar; dit zegt niets over bestaande portaalfuncties. Zie het [actuele releasebereik](/developers/guides/release-scope?lang=nl).

# Publieke portaalinstellingen

Interne beheerders kunnen de publieke portaalnaam en het contactadres aanpassen. De naam verschijnt in de paginatitel en voettekst; het contactadres staat in de voettekst. Deze instellingen gelden voor **het volledige portaal en alle bedrijven**, ook wanneer een beheerder een specifieke bedrijfscontext heeft geselecteerd.

Dit beheer wijzigt geen SMTP-verzendadres, portaal-URL, inlogbeleid, leveranciersverbinding, valuta, btw of facturatie. De overeenkomstige serverinstellingen zijn in het scherm alleen ter informatie zichtbaar. Oude bedrijfsspecifieke configuratieregels, stijl en logo blijven behouden; deze functie bewerkt uitsluitend de bestaande globale naam en het contactadres.

## In het portaal

Open **Portaalinstellingen**, vul de publieke naam en het contactadres in, bevestig dat de wijziging voor alle bedrijven geldt en kies **Portaalgegevens opslaan**. Bevestig met een recente passkey. De volgende pagina toont de nieuwe gegevens. Er worden geen e-mails verstuurd.

Is het antwoord onderbroken, herlaad het scherm en controleer de werkelijk opgeslagen waarden voordat je opnieuw wijzigt. Het formulier herhaalt een onduidelijke schrijfactie niet automatisch. Wanneer een andere beheerder de instellingen heeft gewijzigd, wordt je verouderde versie geweigerd; beoordeel dan eerst de nieuwe waarden.

## CLI

Log in als menselijke interne beheerder. `--account` selecteert de beheercontext en beperkt deze globale wijziging niet tot dat bedrijf.

```sh
binadit admin portal-settings get --account 1
binadit admin portal-settings update --account 1 --version CURRENT_VERSION --confirm-global --from-file branding.json --dry-run
binadit admin portal-settings update --account 1 --version CURRENT_VERSION --confirm-global --from-file branding.json
```

Vervang `CURRENT_VERSION` door de `version` uit `get`. Het JSON-bestand bevat alleen:

```json
{
  "app_name": "Voorbeeldportal",
  "contact_email": "help@example.com"
}
```

Gebruik een privébestand of vertrouwde stdin; op Windows voer je JSON in via `--from-file -`. Gebruik voor onbemande invoer `--yes`, maar behoud de expliciete `--confirm-global` en actuele menselijke beheerdersverificatie. Een automatiseringssleutel krijgt geen toegang tot dit beheer. `--dry-run` controleert de opdracht zonder instellingen of een wijzigingsbewerking op te slaan.

## API

| Methode en pad | Scope | Werking |
| --- | --- | --- |
| `GET /api/v1/accounts/{context}/admin/portal-settings` | `admin:read` | Globale naam, contactadres, `scope: global` en versie; ETag in de headers |
| `PUT /api/v1/accounts/{context}/admin/portal-settings` | `admin:write` | Exact beoordeelde globale gegevens opslaan |

Beide endpoints vereisen een actuele menselijke interne beheerder met recente passkeyverificatie. Een PUT bevat `app_name`, `contact_email` en `confirm_global: true`, plus optioneel `dry_run: true`. Stuur de actuele `If-Match` en een blijvende `Idempotency-Key`. Een ontbrekende versie geeft `428`; een gewijzigde versie `412`; ongeldige of niet-ondersteunde velden `422`. De wijziging en audit worden atomair opgeslagen. Eén gedeelde databasevergrendeling voorkomt dat twee eerste wijzigingen meerdere globale configuraties aanmaken. Reeds bestaande dubbele globale configuraties geven `409` en vereisen correctie vóór opslaan.

Bij een verloren antwoord bewaar je de oorspronkelijke berichtinhoud en idempotentiesleutel. Lees de opgeslagen gegevens of de oorspronkelijke bewerking. Een herhaling met dezelfde sleutel geeft de oorspronkelijke bevestigde uitkomst; vervang de sleutel niet om een versieconflict te omzeilen.

## Instructies voor AI-agents

De globale reikwijdte is een wezenlijke eigenschap: behoud expliciet `confirm_global: true` en laat zien dat de wijziging ieder bedrijf raakt. Interpreteer `--account` nooit als een bedrijfsspecifiek doel voor huisstijl. Lees de actuele versie, beoordeel de exacte twee publieke velden en gebruik een oorspronkelijke idempotentiesleutel voor schrijfacties. Controleer bij onzekerheid de actuele instellingen en de oorspronkelijke bewerking in plaats van succes te raden. Breid dit endpoint niet uit met SMTP-, authenticatie-, leveranciers-, betalings- of belastinginstellingen. Plaats nooit sleutels of andere inloggegevens in de publieke naam of het contactveld.