> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Mettre à jour un domaine personnalisé
> PATCH /custom-domain/{pk}/
Met à jour la configuration d'un domaine personnalisé, sur l'hôte de l'**API de gestion** (`api.scanova.io`), authentifié avec votre clé d'API de gestion brute.
```
PUT https://api.scanova.io/custom-domain/{pk}/
PATCH https://api.scanova.io/custom-domain/{pk}/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
```
Le `id` du domaine.
Si les nouveaux codes QR utilisent ce domaine par défaut.
Ce qu'il faut faire lorsque quelqu'un visite le domaine nu (sans slug QR) : `no_action` (par défaut), `url_redirect`, ou `custom_page`.
L'URL vers laquelle envoyer les visiteurs lorsque `root_action` est `url_redirect`.
Un id `CustomDomainTemplate` servant de page racine lorsque `root_action` est `custom_page` — voir [Lister les modèles de page racine de domaine personnalisé](/fr/api-reference/management-api/custom-domain/templates-list).
`none`, `http`, ou `https`. Vide correspond par défaut à `https`.
Retire le paramètre de suivi `?qr=1` des URL de lien court lorsqu'il est défini.
```bash cURL theme={null}
curl -X PATCH "https://api.scanova.io/custom-domain/42/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{
"root_action": "url_redirect",
"redirect": "https://example.com/landing"
}'
```
```json 200 theme={null}
{
"id": 42,
"domain": "https://links.example.com",
"is_default": false,
"disable_slug_case": false,
"txt_value": "scanova-verification=abc123...",
"is_txt_verified": true,
"is_cname_verified": true,
"is_migrated": false,
"dns_provider": { "name": "Cloudflare", "placeholders": { "cname": { "content": { "label": "Target" } } } },
"txt_error": null,
"cname_error": null,
"root_action": "url_redirect",
"redirect": "https://example.com/landing",
"template": null,
"protocol": "https",
"remove_qr_query": false,
"cname_target": "shortcname.scanova.io",
"domain_connect_supported": false,
"domain_connect_checked_at": null,
"created": "2026-09-08T10:00:00Z",
"modified": "2026-09-08T10:00:00Z"
}
```
## La plupart des champs sont en lecture seule ici
Seuls `is_default`, `root_action`, `redirect`, `template`, `protocol` et `remove_qr_query` peuvent être écrits via cet endpoint — tous les autres champs, y compris `domain` lui-même, sont en lecture seule une fois le domaine créé. `404` si `pk` n'est pas un domaine appartenant à ce compte.
## Voir aussi
* [Récupérer un domaine personnalisé](/fr/api-reference/management-api/custom-domain/retrieve) — consulter avant de mettre à jour.
* [Lister les modèles de page racine de domaine personnalisé](/fr/api-reference/management-api/custom-domain/templates-list) — trouver un id `template` pour `custom_page`.
* [Présentation de l'API de gestion](/fr/api-reference/management-api/overview) — le schéma d'authentification et les règles de quota applicables à cet endpoint.
## OpenAPI
````yaml api-reference/openapi/management-api.json PATCH /custom-domain/{pk}/
openapi: 3.1.0
info:
title: Scanova Management API (v2)
description: >-
The complete Scanova Management API — every endpoint available at
api.scanova.io (QR codes, folders, tags, leads, forms, analytics, plans,
shared users & roles), plus the token-creation and usage-stats endpoints
used to authenticate against it. Every path and request/response shape below
was verified live against a real API key and the actual running backend
(Phase 7, 2026-08-16) — not guessed from reading urls.py alone.
version: 2.0.0
servers:
- url: https://api.scanova.io
description: Management API — QR/folder/tag/lead/form/analytics/plans endpoints
security:
- apiKeyAuth: []
paths:
/custom-domain/{pk}/:
patch:
summary: Update a custom domain
description: >-
Both PUT and PATCH are supported. Only `is_default`, `root_action`,
`redirect`, `template`, `protocol`, and `remove_qr_query` are writable
here — every other field (including `domain` itself) is read-only on
update.
operationId: updateCustomDomain
parameters:
- name: pk
in: path
required: true
schema:
type: integer
requestBody:
content:
application/json:
example:
root_action: url_redirect
redirect: https://example.com/landing
responses:
'200':
description: Domain updated.
content:
application/json:
example:
id: 42
domain: https://links.example.com
is_default: false
disable_slug_case: false
txt_value: scanova-verification=abc123...
is_txt_verified: false
is_cname_verified: false
is_migrated: false
dns_provider:
name: Cloudflare
placeholders:
cname:
content:
label: Target
txt_error: null
cname_error: null
root_action: url_redirect
redirect: https://example.com/landing
template: null
protocol: https
remove_qr_query: false
cname_target: shortcname.scanova.io
domain_connect_supported: false
domain_connect_checked_at: null
created: '2026-09-08T10:00:00Z'
modified: '2026-09-08T10:00:00Z'
'404':
description: No domain with this id owned by this account.
components:
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: Authorization
description: >-
Send your Management API key as the raw value of the Authorization
header — no "Bearer " or "Token " prefix, and no other characters.
Example: `Authorization: 401f7ac837da42b97f613d789819ff93537bee6a`. A
header containing more than one space-separated part is rejected
outright. Requests also require the request's Host header to be the
management API host (e.g. api.scanova.io) — the same key sent to the
regular API host will not authenticate.
````