> ## 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.
# Créer un modèle de page
> POST /page-template/
Enregistre un nouveau modèle de page, sur l'hôte de l'**API de gestion** (`api.scanova.io`), authentifié avec votre clé d'API de gestion brute.
```
POST https://api.scanova.io/page-template/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
```
Nom du modèle. Les noms vides ou contenant uniquement des espaces sont rejetés.
Description du modèle.
Le contenu en blocs de la page — soit une liste de blocs, soit un dictionnaire contenant une clé `pages`. Toute autre forme est rejetée.
Un id de thème à associer à ce modèle. Si le thème n'est pas un thème système, il doit vous appartenir.
Couleur d'accent, utilisée comme repli lorsque le thème lié n'en résout pas une en direct.
Couleur de fond d'aperçu, même rôle de repli que `accent_color`.
```bash cURL theme={null}
curl -X POST "https://api.scanova.io/page-template/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{
"name": "My Landing Page",
"description": "A custom page.",
"blocks_json": [{ "type": "hero" }],
"theme": 7,
"accent_color": "#0077be",
"preview_bg": "#f0f8ff"
}'
```
```json 201 theme={null}
{
"id": 9,
"name": "My Landing Page",
"slug": "user-42-my-landing-page-d4e5f6",
"description": "A custom page.",
"category": null,
"theme": {
"id": 7,
"name": "Ocean Breeze",
"slug": "user-42-ocean-breeze-a1b2c3",
"description": "A cool blue palette.",
"config_json": { "color": { "accent": "#0077be", "background": "#f0f8ff" } },
"schema_version": 2,
"category_hints": ["website-url"],
"thumbnail_url": "https://cdn.scanova.io/themes/7/thumb.png",
"is_system": false,
"is_premium": false,
"order": 0
},
"blocks_json": [{ "type": "hero" }],
"filter_tags": [],
"accent_color": "#0077be",
"preview_bg": "#f0f8ff",
"thumbnail_url": null,
"is_premium": false,
"is_system": false,
"is_favourited": false,
"order": 0
}
```
`slug` est généré côté serveur. Une miniature est générée de manière asynchrone après la création — `thumbnail_url` commence à `null` et se remplit une fois cette étape terminée.
`400` pour un `name` vide, un `blocks_json` mal formé, ou un `theme` qui n'est pas un thème système et ne vous appartient pas.
## Voir aussi
* [Lister les modèles de page](/fr/api-reference/management-api/theme-manager/page-template-list) — voir les modèles enregistrés (`?mine=true`).
* [Mettre à jour un modèle de page](/fr/api-reference/management-api/theme-manager/page-template-update) — modifier un modèle existant.
* [Créer un thème](/fr/api-reference/management-api/theme-manager/theme-create) — créer un thème à lier via `theme`.
* [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 POST /page-template/
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:
/page-template/:
post:
summary: Create a page template
description: >-
Requires authentication. `slug` is generated server-side. A thumbnail is
generated asynchronously after creation.
operationId: createPageTemplate
requestBody:
content:
application/json:
example:
name: My Landing Page
description: A custom page.
blocks_json:
- type: hero
theme: 7
accent_color: '#0077be'
preview_bg: '#f0f8ff'
responses:
'201':
description: Template created.
content:
application/json:
example:
id: 9
name: My Landing Page
slug: user-42-my-landing-page-d4e5f6
description: A custom page.
category: null
theme:
id: 7
name: Ocean Breeze
slug: user-42-ocean-breeze-a1b2c3
description: A cool blue palette.
config_json:
color:
accent: '#0077be'
background: '#f0f8ff'
font:
heading: Inter
schema_version: 2
category_hints:
- website-url
- vcard
thumbnail_url: https://cdn.scanova.io/themes/7/thumb.png
is_system: false
is_premium: false
order: 0
blocks_json:
- type: hero
filter_tags: []
accent_color: '#0077be'
preview_bg: '#f0f8ff'
thumbnail_url: null
is_premium: false
is_system: false
is_favourited: false
order: 0
'400':
description: >-
Blank name, malformed blocks_json (must be a list, or a dict with a
pages key), or theme references a system-ineligible or another
account's non-system theme.
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.
````