> ## 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.
# Actualizar un dominio personalizado
> PATCH /custom-domain/{pk}/
Actualiza la configuración de un dominio personalizado, en el host de la **API de gestión** (`api.scanova.io`), autenticado con su clave de API de gestión sin procesar.
```
PUT https://api.scanova.io/custom-domain/{pk}/
PATCH https://api.scanova.io/custom-domain/{pk}/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
```
El `id` del dominio.
Si los nuevos códigos QR usan este dominio de forma predeterminada.
Qué hacer cuando alguien visita el dominio desnudo (sin slug de QR): `no_action` (predeterminado), `url_redirect` o `custom_page`.
La URL a la que se envía a los visitantes cuando `root_action` es `url_redirect`.
Un id de `CustomDomainTemplate` que sirve como página raíz cuando `root_action` es `custom_page` — consulte [Listar plantillas de página raíz de dominio personalizado](/es/api-reference/management-api/custom-domain/templates-list).
`none`, `http` o `https`. En blanco se establece por defecto en `https`.
Elimina el parámetro de seguimiento `?qr=1` de las URL de enlace corto cuando se establece.
```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 mayoría de los campos son de solo lectura aquí
Solo `is_default`, `root_action`, `redirect`, `template`, `protocol` y `remove_qr_query` se pueden escribir a través de este endpoint — todos los demás campos, incluido `domain` en sí, son de solo lectura una vez creado el dominio. `404` si `pk` no es un dominio propiedad de esta cuenta.
## Relacionado
* [Obtener un dominio personalizado](/es/api-reference/management-api/custom-domain/retrieve) — ver antes de actualizar.
* [Listar plantillas de página raíz de dominio personalizado](/es/api-reference/management-api/custom-domain/templates-list) — encontrar un id de `template` para `custom_page`.
* [Resumen de la API de gestión](/es/api-reference/management-api/overview) — el esquema de autenticación y las reglas de cuota aplicables a este 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.
````