**Versions de l’API** · [V2 (Latest)](/integrations/v2/docs?lang=fr) · **V1**

> **Cette version de l’API est obsolète.** Utilisez la dernière version pour toute nouvelle intégration. [Voir la documentation actuelle](/integrations/v2/docs?lang=fr)

# Pages

OpenAPI 3.0.3 · API 1.0.0

```json
[
  {
    "url": "https://api.unisoft.world/integrations/v1",
    "description": "API"
  }
]
```

Pages personnalisées du site. Les métadonnées sont toujours modifiables ; le contenu HTML ne l’est que pour les pages IA (convention data-i18n, voir PageContentInput). Toute page créée ici est une page IA. Autorisations : `pages:read`/`pages:write`.

## Opérations

## GET /pages

Lister les pages

`list_pages`

Autorisation requise : `pages:read`. Liste les pages de l’organisation (champs succincts + `url` concaténée). Résultats paginés.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "pages:read",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  },
  "description": "Nombre de résultats par page."
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Curseur opaque renvoyé par la requête précédente."
}
```

```json
{
  "name": "active",
  "in": "query",
  "schema": {
    "type": "boolean"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Page"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "ERREUR",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "ERROR"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "pages:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /pages

Créer une page

`create_page`

Autorisation requise : `pages:write`. Crée une page IA (son contenu peut ensuite être défini via PUT /pages/{id}/content). `url` est normalisée en segments de slug et doit être unique.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "pages:write",
  "additional": []
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PageInput"
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/Page"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "VALIDATION_ERROR ou URL_ALREADY_USED",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR or URL_ALREADY_USED"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "pages:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

## GET /pages/{id}

Obtenir une page

`get_page`

Autorisation requise : `pages:read`. Page complète, incluant son SEO (metaTitle/metaDescription/metaImage et surcharges linguistiques), `html`/`i18n` et l’indicateur `aiEditable`.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "pages:read",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/Page"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "pages:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## PATCH /pages/{id}

Modifier les métadonnées d’une page

`update_page`

Autorisation requise : `pages:write`. Mise à jour partielle des métadonnées (label/title/description/url/active) et du SEO de page (metaTitle/metaDescription/metaImage, avec surcharges pour les autres langues). Fonctionne sur les pages IA et anciennes sans modifier leur contenu ni leur éditeur. Les champs et traductions omis sont conservés. Les champs SEO null/vides rétablissent les valeurs par défaut du site, puis les valeurs automatiques. Les images SEO HTTP(S) sont réhébergées, traductions comprises ; un échec d’importation refuse l’écriture. L’URL de la page d’accueil est verrouillée.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "pages:write",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PageUpdateInput"
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/Page"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "VALIDATION_ERROR, URL_ALREADY_USED ou MAIN_PAGE_URL_LOCKED",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR or URL_ALREADY_USED or MAIN_PAGE_URL_LOCKED"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "pages:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## PUT /pages/{id}/content

Définir le contenu IA (HTML) d’une page

`set_page_content`

Autorisation requise : `pages:write`. Définit le HTML de la page ; le serveur injecte les clés data-i18n et fusionne les traductions (voir PageContentInput). Refusé avec PAGE_CONTENT_NOT_EDITABLE pour les pages de l’ancien éditeur visuel.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "pages:write",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PageContentInput"
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "VALIDATION_ERROR ou PAGE_CONTENT_NOT_EDITABLE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR or PAGE_CONTENT_NOT_EDITABLE"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "pages:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /pages/{id}/translations

Définir les traductions d’une page

`set_page_translations`

Autorisation requise : `pages:write`. Met à jour, pour une langue, les traductions des clés data-i18n existantes. Ne modifie pas le HTML. Refusé pour les anciennes pages.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "pages:write",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PageTranslationsInput"
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "VALIDATION_ERROR ou PAGE_CONTENT_NOT_EDITABLE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR or PAGE_CONTENT_NOT_EDITABLE"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "pages:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /pages/{id}/activate

Publier une page

`activate_page`

Autorisation requise : `pages:write`.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "pages:write",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "pages:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /pages/{id}/deactivate

Dépublier une page

`deactivate_page`

Autorisation requise : `pages:write`.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "pages:write",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "pages:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## Schémas

```json
{
  "components": {
    "parameters": {
      "LimitParam": {
        "name": "limit",
        "in": "query",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "maximum": 200,
          "default": 50
        },
        "description": "Nombre de résultats par page."
      },
      "CursorParam": {
        "name": "cursor",
        "in": "query",
        "schema": {
          "type": "string"
        },
        "description": "Curseur opaque renvoyé par la requête précédente."
      },
      "IdParam": {
        "name": "id",
        "in": "path",
        "required": true,
        "schema": {
          "type": "string",
          "format": "uuid",
          "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
        },
        "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
      }
    },
    "schemas": {
      "Page": {
        "type": "object",
        "description": "Page personnalisée du site web. Identifiée par `route` (segments du slug) — `url` est la route concaténée. Le contenu est soit généré par IA (`html`+`i18n`+`mainLang`), soit issu de l’ancien éditeur visuel (`content`) ; `aiEditable` indique si le contenu peut être modifié via cette API.",
        "properties": {
          "id": {
            "type": "string"
          },
          "organisation": {
            "type": "string"
          },
          "type": {
            "type": "string",
            "enum": [
              "MAIN_PAGE",
              "CUSTOM_PAGE"
            ],
            "description": "MAIN_PAGE = ancienne page d’accueil (URL verrouillée ; n’est plus créée automatiquement) ; CUSTOM_PAGE = page standard."
          },
          "editorType": {
            "type": "string",
            "enum": [
              "AI",
              "EDITOR"
            ],
            "description": "Éditeur propriétaire du contenu : \"AI\" (html + data-i18n, seul type modifiable via cette API) ou \"EDITOR\" (ancien éditeur visuel). Les pages créées via cette API sont toujours de type \"AI\"."
          },
          "label": {
            "type": "string",
            "description": "Libellé interne."
          },
          "title": {
            "type": "string",
            "description": "Titre public de la page."
          },
          "description": {
            "type": "string",
            "description": "Description de la page ; utilisée comme valeur SEO de repli automatique si aucune description SEO de page/site n’est définie."
          },
          "metaTitle": {
            "type": "string",
            "nullable": true,
            "description": "Titre SEO et de partage propre à la page ; remplace la valeur par défaut du site sans modifier le titre visible. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
          },
          "metaDescription": {
            "type": "string",
            "nullable": true,
            "description": "Description meta et de partage propre à la page ; remplace la valeur par défaut du site. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
          },
          "metaImage": {
            "type": "string",
            "nullable": true,
            "description": "Image de partage propre à la page : URL HTTP(S) (réhébergée côté serveur) ou nom de fichier déjà hébergé, y compris les images traduites. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
          },
          "fr": {
            "type": "object",
            "nullable": true,
            "properties": {
              "metaTitle": {
                "type": "string",
                "nullable": true,
                "description": "Titre SEO et de partage propre à la page ; remplace la valeur par défaut du site sans modifier le titre visible. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaDescription": {
                "type": "string",
                "nullable": true,
                "description": "Description meta et de partage propre à la page ; remplace la valeur par défaut du site. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaImage": {
                "type": "string",
                "nullable": true,
                "description": "Image de partage propre à la page : URL HTTP(S) (réhébergée côté serveur) ou nom de fichier déjà hébergé, y compris les images traduites. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              }
            },
            "additionalProperties": true,
            "description": "Champs de page traduits, y compris les personnalisations SEO. D’autres contenus de page traduits peuvent également être présents."
          },
          "en": {
            "type": "object",
            "nullable": true,
            "properties": {
              "metaTitle": {
                "type": "string",
                "nullable": true,
                "description": "Titre SEO et de partage propre à la page ; remplace la valeur par défaut du site sans modifier le titre visible. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaDescription": {
                "type": "string",
                "nullable": true,
                "description": "Description meta et de partage propre à la page ; remplace la valeur par défaut du site. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaImage": {
                "type": "string",
                "nullable": true,
                "description": "Image de partage propre à la page : URL HTTP(S) (réhébergée côté serveur) ou nom de fichier déjà hébergé, y compris les images traduites. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              }
            },
            "additionalProperties": true,
            "description": "Champs de page traduits, y compris les personnalisations SEO. D’autres contenus de page traduits peuvent également être présents."
          },
          "he": {
            "type": "object",
            "nullable": true,
            "properties": {
              "metaTitle": {
                "type": "string",
                "nullable": true,
                "description": "Titre SEO et de partage propre à la page ; remplace la valeur par défaut du site sans modifier le titre visible. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaDescription": {
                "type": "string",
                "nullable": true,
                "description": "Description meta et de partage propre à la page ; remplace la valeur par défaut du site. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaImage": {
                "type": "string",
                "nullable": true,
                "description": "Image de partage propre à la page : URL HTTP(S) (réhébergée côté serveur) ou nom de fichier déjà hébergé, y compris les images traduites. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              }
            },
            "additionalProperties": true,
            "description": "Champs de page traduits, y compris les personnalisations SEO. D’autres contenus de page traduits peuvent également être présents."
          },
          "it": {
            "type": "object",
            "nullable": true,
            "properties": {
              "metaTitle": {
                "type": "string",
                "nullable": true,
                "description": "Titre SEO et de partage propre à la page ; remplace la valeur par défaut du site sans modifier le titre visible. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaDescription": {
                "type": "string",
                "nullable": true,
                "description": "Description meta et de partage propre à la page ; remplace la valeur par défaut du site. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaImage": {
                "type": "string",
                "nullable": true,
                "description": "Image de partage propre à la page : URL HTTP(S) (réhébergée côté serveur) ou nom de fichier déjà hébergé, y compris les images traduites. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              }
            },
            "additionalProperties": true,
            "description": "Champs de page traduits, y compris les personnalisations SEO. D’autres contenus de page traduits peuvent également être présents."
          },
          "ru": {
            "type": "object",
            "nullable": true,
            "properties": {
              "metaTitle": {
                "type": "string",
                "nullable": true,
                "description": "Titre SEO et de partage propre à la page ; remplace la valeur par défaut du site sans modifier le titre visible. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaDescription": {
                "type": "string",
                "nullable": true,
                "description": "Description meta et de partage propre à la page ; remplace la valeur par défaut du site. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaImage": {
                "type": "string",
                "nullable": true,
                "description": "Image de partage propre à la page : URL HTTP(S) (réhébergée côté serveur) ou nom de fichier déjà hébergé, y compris les images traduites. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              }
            },
            "additionalProperties": true,
            "description": "Champs de page traduits, y compris les personnalisations SEO. D’autres contenus de page traduits peuvent également être présents."
          },
          "pt": {
            "type": "object",
            "nullable": true,
            "properties": {
              "metaTitle": {
                "type": "string",
                "nullable": true,
                "description": "Titre SEO et de partage propre à la page ; remplace la valeur par défaut du site sans modifier le titre visible. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaDescription": {
                "type": "string",
                "nullable": true,
                "description": "Description meta et de partage propre à la page ; remplace la valeur par défaut du site. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaImage": {
                "type": "string",
                "nullable": true,
                "description": "Image de partage propre à la page : URL HTTP(S) (réhébergée côté serveur) ou nom de fichier déjà hébergé, y compris les images traduites. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              }
            },
            "additionalProperties": true,
            "description": "Champs de page traduits, y compris les personnalisations SEO. D’autres contenus de page traduits peuvent également être présents."
          },
          "de": {
            "type": "object",
            "nullable": true,
            "properties": {
              "metaTitle": {
                "type": "string",
                "nullable": true,
                "description": "Titre SEO et de partage propre à la page ; remplace la valeur par défaut du site sans modifier le titre visible. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaDescription": {
                "type": "string",
                "nullable": true,
                "description": "Description meta et de partage propre à la page ; remplace la valeur par défaut du site. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaImage": {
                "type": "string",
                "nullable": true,
                "description": "Image de partage propre à la page : URL HTTP(S) (réhébergée côté serveur) ou nom de fichier déjà hébergé, y compris les images traduites. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              }
            },
            "additionalProperties": true,
            "description": "Champs de page traduits, y compris les personnalisations SEO. D’autres contenus de page traduits peuvent également être présents."
          },
          "es": {
            "type": "object",
            "nullable": true,
            "properties": {
              "metaTitle": {
                "type": "string",
                "nullable": true,
                "description": "Titre SEO et de partage propre à la page ; remplace la valeur par défaut du site sans modifier le titre visible. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaDescription": {
                "type": "string",
                "nullable": true,
                "description": "Description meta et de partage propre à la page ; remplace la valeur par défaut du site. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaImage": {
                "type": "string",
                "nullable": true,
                "description": "Image de partage propre à la page : URL HTTP(S) (réhébergée côté serveur) ou nom de fichier déjà hébergé, y compris les images traduites. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              }
            },
            "additionalProperties": true,
            "description": "Champs de page traduits, y compris les personnalisations SEO. D’autres contenus de page traduits peuvent également être présents."
          },
          "gr": {
            "type": "object",
            "nullable": true,
            "properties": {
              "metaTitle": {
                "type": "string",
                "nullable": true,
                "description": "Titre SEO et de partage propre à la page ; remplace la valeur par défaut du site sans modifier le titre visible. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaDescription": {
                "type": "string",
                "nullable": true,
                "description": "Description meta et de partage propre à la page ; remplace la valeur par défaut du site. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaImage": {
                "type": "string",
                "nullable": true,
                "description": "Image de partage propre à la page : URL HTTP(S) (réhébergée côté serveur) ou nom de fichier déjà hébergé, y compris les images traduites. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              }
            },
            "additionalProperties": true,
            "description": "Champs de page traduits, y compris les personnalisations SEO. D’autres contenus de page traduits peuvent également être présents."
          },
          "ro": {
            "type": "object",
            "nullable": true,
            "properties": {
              "metaTitle": {
                "type": "string",
                "nullable": true,
                "description": "Titre SEO et de partage propre à la page ; remplace la valeur par défaut du site sans modifier le titre visible. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaDescription": {
                "type": "string",
                "nullable": true,
                "description": "Description meta et de partage propre à la page ; remplace la valeur par défaut du site. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaImage": {
                "type": "string",
                "nullable": true,
                "description": "Image de partage propre à la page : URL HTTP(S) (réhébergée côté serveur) ou nom de fichier déjà hébergé, y compris les images traduites. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              }
            },
            "additionalProperties": true,
            "description": "Champs de page traduits, y compris les personnalisations SEO. D’autres contenus de page traduits peuvent également être présents."
          },
          "route": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Chemin d’URL sous forme de segments de slug (par ex. [\"infos\",\"horaires\"])."
          },
          "url": {
            "type": "string",
            "readOnly": true,
            "description": "Route concaténée (\"infos/horaires\"). Champ pratique en lecture seule."
          },
          "active": {
            "type": "boolean"
          },
          "html": {
            "type": "string",
            "description": "HTML du contenu IA (avec attributs data-i18n). Présent sur les pages IA."
          },
          "mainLang": {
            "type": "string",
            "nullable": true,
            "description": "Langue par défaut du contenu HTML."
          },
          "i18n": {
            "type": "object",
            "description": "Traductions : { lang: { i18nKey: value } } pour les clés data-i18n du HTML.",
            "additionalProperties": true
          },
          "aiEditable": {
            "type": "boolean",
            "readOnly": true,
            "description": "Indique si le contenu de la page peut être modifié via PUT /pages/{id}/content (false pour les pages de l’ancien éditeur visuel)."
          },
          "datetime": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "nextCursor": {
            "type": "string",
            "nullable": true
          },
          "hasMore": {
            "type": "boolean"
          },
          "count": {
            "type": "integer"
          }
        }
      },
      "PageInput": {
        "type": "object",
        "description": "Données pour créer ou modifier les métadonnées et le SEO d’une page (metaTitle/metaDescription/metaImage). Une page créée ici est une page IA (son contenu peut ensuite être défini via PUT /pages/{id}/content). Avec un PATCH partiel, seuls les champs fournis sont modifiés, y compris dans une surcharge linguistique. La modification du SEO fonctionne pour les pages IA et celles de l’ancien éditeur. La langue par défaut reste à la racine ; les autres langues activées utilisent des surcharges. Les champs SEO remplacent chacun indépendamment les valeurs du site ; null/champ vide rétablit la valeur de repli. Ce mécanisme est distinct des traductions HTML data-i18n.",
        "required": [
          "title",
          "url"
        ],
        "properties": {
          "label": {
            "type": "string",
            "description": "Libellé interne."
          },
          "title": {
            "type": "string",
            "description": "Titre public de la page (obligatoire à la création)."
          },
          "description": {
            "type": "string",
            "description": "Description de la page ; valeur SEO de repli automatique lorsqu’aucune description SEO de page/site n’est définie."
          },
          "metaTitle": {
            "type": "string",
            "nullable": true,
            "description": "Titre SEO et de partage propre à la page ; remplace la valeur par défaut du site sans modifier le titre visible. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
          },
          "metaDescription": {
            "type": "string",
            "nullable": true,
            "description": "Description meta et de partage propre à la page ; remplace la valeur par défaut du site. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
          },
          "metaImage": {
            "type": "string",
            "nullable": true,
            "description": "Image de partage propre à la page : URL HTTP(S) (réhébergée côté serveur) ou nom de fichier déjà hébergé, y compris les images traduites. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
          },
          "fr": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "en": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "he": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "it": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "ru": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "pt": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "de": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "es": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "gr": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "ro": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "url": {
            "type": "string",
            "description": "URL de la page, par ex. \"infos/horaires\" (obligatoire à la création). Normalisée côté serveur en segments de slug ; doit être unique et ne pas entrer en conflit avec une page intégrée. L’URL de la page d’accueil ne peut pas être modifiée."
          },
          "active": {
            "type": "boolean",
            "description": "Indique si la page est publiée (true par défaut)."
          }
        }
      },
      "PageSeoOverlay": {
        "type": "object",
        "nullable": true,
        "additionalProperties": false,
        "description": "Traduction SEO partielle pour une autre langue activée. La langue par défaut de l’organisation reste à la racine. Seuls les champs fournis sont modifiés. Null ou un objet vide efface uniquement le SEO de cette langue et préserve les autres traductions du contenu de la page ; l’effacement d’un SEO obsolète reste autorisé après désactivation d’une langue. Les champs acceptent null/chaînes vides pour rétablir la valeur de repli. À distinguer des dictionnaires i18n du HTML.",
        "properties": {
          "metaTitle": {
            "type": "string",
            "nullable": true,
            "description": "Titre SEO et de partage propre à la page ; remplace la valeur par défaut du site sans modifier le titre visible. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
          },
          "metaDescription": {
            "type": "string",
            "nullable": true,
            "description": "Description meta et de partage propre à la page ; remplace la valeur par défaut du site. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
          },
          "metaImage": {
            "type": "string",
            "nullable": true,
            "description": "Image de partage propre à la page : URL HTTP(S) (réhébergée côté serveur) ou nom de fichier déjà hébergé, y compris les images traduites. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
          }
        }
      },
      "PageUpdateInput": {
        "type": "object",
        "description": "Mise à jour partielle des métadonnées et du SEO d’une page. Seuls les champs fournis sont modifiés, y compris dans les surcharges SEO des autres langues ; aucun champ n’est obligatoire. Les champs SEO null/vides rétablissent les valeurs par défaut du site, puis les valeurs automatiques. Les champs de la langue par défaut restent à la racine.",
        "properties": {
          "label": {
            "type": "string",
            "description": "Libellé interne."
          },
          "title": {
            "type": "string",
            "description": "Titre public de la page (obligatoire à la création)."
          },
          "description": {
            "type": "string",
            "description": "Description de la page ; valeur SEO de repli automatique lorsqu’aucune description SEO de page/site n’est définie."
          },
          "metaTitle": {
            "type": "string",
            "nullable": true,
            "description": "Titre SEO et de partage propre à la page ; remplace la valeur par défaut du site sans modifier le titre visible. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
          },
          "metaDescription": {
            "type": "string",
            "nullable": true,
            "description": "Description meta et de partage propre à la page ; remplace la valeur par défaut du site. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
          },
          "metaImage": {
            "type": "string",
            "nullable": true,
            "description": "Image de partage propre à la page : URL HTTP(S) (réhébergée côté serveur) ou nom de fichier déjà hébergé, y compris les images traduites. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
          },
          "fr": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "en": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "he": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "it": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "ru": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "pt": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "de": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "es": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "gr": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "ro": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "url": {
            "type": "string",
            "description": "URL de la page, par ex. \"infos/horaires\" (obligatoire à la création). Normalisée côté serveur en segments de slug ; doit être unique et ne pas entrer en conflit avec une page intégrée. L’URL de la page d’accueil ne peut pas être modifiée."
          },
          "active": {
            "type": "boolean",
            "description": "Indique si la page est publiée (true par défaut)."
          }
        }
      },
      "PageContentInput": {
        "type": "object",
        "description": "Contenu HTML d’une page IA. Envoyez du HTML BRUT — vous n’avez PAS à gérer vous-même les clés de traduction. Le serveur traite le HTML et ajoute un attribut `data-i18n=\"<key>\"` sur chaque nœud de texte traduisible qui n’en possède pas (et `data-i18n-alt`/`-title`/`-placeholder`/`-aria-label` pour ces attributs), en générant des clés telles que `auto_1`. Le texte de `mainLang` devient le dictionnaire de référence ; les traductions existantes dans les autres langues sont conservées et les clés obsolètes supprimées. Pour traduire, relisez la page afin d’obtenir les clés, puis appelez POST /pages/{id}/translations avec `{lang, dict:{key:value}}`. Refusé avec PAGE_CONTENT_NOT_EDITABLE pour les pages de l’ancien éditeur.",
        "required": [
          "html"
        ],
        "properties": {
          "html": {
            "type": "string",
            "description": "HTML de la page (fragment ou document complet). Les clés data-i18n sont ajoutées automatiquement."
          },
          "mainLang": {
            "type": "string",
            "description": "Langue utilisée pour rédiger le HTML (par ex. \"fr\"). Par défaut, mainLang actuel de la page ou langue par défaut de l’organisation."
          },
          "assets": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Noms de fichiers facultatifs des ressources référencées dans le HTML."
          }
        }
      },
      "PageTranslationsInput": {
        "type": "object",
        "description": "Traductions des clés data-i18n existantes d’une page IA pour une langue. Ne modifie pas le HTML. Lisez la page (son `i18n` et les clés `data-i18n` de `html`) pour découvrir les clés.",
        "required": [
          "lang",
          "dict"
        ],
        "properties": {
          "lang": {
            "type": "string",
            "description": "Code de la langue cible (par ex. \"en\", \"he\")."
          },
          "dict": {
            "type": "object",
            "description": "{ i18nKey: translatedValue } (valeur traduite).",
            "additionalProperties": {
              "type": "string"
            }
          }
        }
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key",
        "description": "Format : `ke_live_xxx`"
      },
      "apiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  }
}
```
