**גרסאות API** · [V2 (Latest)](/integrations/v2/docs?lang=he) · **V1**

> **גרסה זו של ה־API מיושנת.** לחיבורים חדשים יש להשתמש בגרסה העדכנית ביותר. [לתיעוד העדכני](/integrations/v2/docs?lang=he)

# Pages

OpenAPI 3.0.3 · API 1.0.0

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

Custom website pages. Metadata is always editable; the HTML content is editable only for AI pages (data-i18n convention, see PageContentInput). A page created here is an AI page. Scopes: `pages:read`/`pages:write`.

## פעולות

## GET /pages

List pages

`list_pages`

Required scope: `pages:read`. Lists the org's pages (light fields + joined `url`). Paginated.

### אימות

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

### הרשאות נדרשות

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

### פרמטרים

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  },
  "description": "Number of results per page"
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Opaque cursor returned by the previous request"
}
```

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

### תגובות

#### 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": "ERROR",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "ERROR"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE",
  "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

Create a page

`create_page`

Required scope: `pages:write`. Creates an AI page (content can then be set via PUT /pages/{id}/content). `url` is normalised to slug segments and must be unique.

### אימות

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

### הרשאות נדרשות

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

### גוף הבקשה

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

### תגובות

#### 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 or 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": "INSUFFICIENT_SCOPE",
  "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}

Get a page

`get_page`

Required scope: `pages:read`. Full page incl. page SEO (metaTitle/metaDescription/metaImage and language overlays), `html`/`i18n` and the `aiEditable` flag.

### אימות

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

### הרשאות נדרשות

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

### פרמטרים

```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": "Resource id — must be a UUID. A malformed id is rejected with 400 INVALID_UUID (it is not just a 404). Need a fresh one? Call GET /utils/uuid."
}
```

### תגובות

#### 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}

Edit page metadata

`update_page`

Required scope: `pages:write`. Partial update of metadata (label/title/description/url/active) and page SEO (metaTitle/metaDescription/metaImage, with alternate-language overlays). Works on AI and legacy pages without modifying their content or editor. Omitted fields and translations are preserved. Null/empty SEO fields restore site defaults, then automatic values. HTTP(S) SEO images are re-hosted, including translations; import failure rejects the write. The home page's URL is locked.

### אימות

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

### הרשאות נדרשות

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

### פרמטרים

```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": "Resource id — must be a UUID. A malformed id is rejected with 400 INVALID_UUID (it is not just a 404). Need a fresh one? Call GET /utils/uuid."
}
```

### גוף הבקשה

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

### תגובות

#### 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 or URL_ALREADY_USED or 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

Set the AI content (HTML) of a page

`set_page_content`

Required scope: `pages:write`. Sets the page HTML; the server injects data-i18n keys and merges translations (see PageContentInput). Refused with PAGE_CONTENT_NOT_EDITABLE on legacy visual-editor pages.

### אימות

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

### הרשאות נדרשות

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

### פרמטרים

```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": "Resource id — must be a UUID. A malformed id is rejected with 400 INVALID_UUID (it is not just a 404). Need a fresh one? Call GET /utils/uuid."
}
```

### גוף הבקשה

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

### תגובות

#### HTTP 200

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

#### HTTP 400

```json
{
  "description": "VALIDATION_ERROR or 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

Set page translations

`set_page_translations`

Required scope: `pages:write`. Updates translations of existing data-i18n keys for one language. Does not change the HTML. Refused on legacy pages.

### אימות

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

### הרשאות נדרשות

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

### פרמטרים

```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": "Resource id — must be a UUID. A malformed id is rejected with 400 INVALID_UUID (it is not just a 404). Need a fresh one? Call GET /utils/uuid."
}
```

### גוף הבקשה

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

### תגובות

#### HTTP 200

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

#### HTTP 400

```json
{
  "description": "VALIDATION_ERROR or 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

Publish a page

`activate_page`

Required scope: `pages:write`.

### אימות

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

### הרשאות נדרשות

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

### פרמטרים

```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": "Resource id — must be a UUID. A malformed id is rejected with 400 INVALID_UUID (it is not just a 404). Need a fresh one? Call GET /utils/uuid."
}
```

### תגובות

#### 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

Unpublish a page

`deactivate_page`

Required scope: `pages:write`.

### אימות

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

### הרשאות נדרשות

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

### פרמטרים

```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": "Resource id — must be a UUID. A malformed id is rejected with 400 INVALID_UUID (it is not just a 404). Need a fresh one? Call GET /utils/uuid."
}
```

### תגובות

#### 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
  }
}
```

## סכמות

```json
{
  "components": {
    "parameters": {
      "LimitParam": {
        "name": "limit",
        "in": "query",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "maximum": 200,
          "default": 50
        },
        "description": "Number of results per page"
      },
      "CursorParam": {
        "name": "cursor",
        "in": "query",
        "schema": {
          "type": "string"
        },
        "description": "Opaque cursor returned by the previous request"
      },
      "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": "Resource id — must be a UUID. A malformed id is rejected with 400 INVALID_UUID (it is not just a 404). Need a fresh one? Call GET /utils/uuid."
      }
    },
    "schemas": {
      "Page": {
        "type": "object",
        "description": "A custom website page. Addressed by `route` (slug segments) — `url` is the joined form. Content is either AI (`html`+`i18n`+`mainLang`) or legacy visual-editor (`content`); `aiEditable` says whether the content can be written via this API.",
        "properties": {
          "id": {
            "type": "string"
          },
          "organisation": {
            "type": "string"
          },
          "type": {
            "type": "string",
            "enum": [
              "MAIN_PAGE",
              "CUSTOM_PAGE"
            ],
            "description": "MAIN_PAGE = a legacy home page (URL locked; no longer created automatically); CUSTOM_PAGE = a normal page."
          },
          "editorType": {
            "type": "string",
            "enum": [
              "AI",
              "EDITOR"
            ],
            "description": "Which editor owns the content: \"AI\" (html + data-i18n, the only kind this API can write) or \"EDITOR\" (legacy visual editor). Pages created via this API are always \"AI\"."
          },
          "label": {
            "type": "string",
            "description": "Internal label."
          },
          "title": {
            "type": "string",
            "description": "Public page title."
          },
          "description": {
            "type": "string",
            "description": "Page description; used as an automatic SEO fallback when no page/site SEO description is set."
          },
          "metaTitle": {
            "type": "string",
            "nullable": true,
            "description": "Page-specific SEO and sharing title; overrides the site default without changing the visible page title. Null or an empty string clears the override and restores the site/automatic fallback."
          },
          "metaDescription": {
            "type": "string",
            "nullable": true,
            "description": "Page-specific meta and sharing description; overrides the site default. Null or an empty string clears the override and restores the site/automatic fallback."
          },
          "metaImage": {
            "type": "string",
            "nullable": true,
            "description": "Page-specific sharing image: HTTP(S) URL (re-hosted server-side) or an already-hosted filename, including translated images. Null or an empty string clears the override and restores the site/automatic fallback."
          },
          "fr": {
            "type": "object",
            "nullable": true,
            "properties": {
              "metaTitle": {
                "type": "string",
                "nullable": true,
                "description": "Page-specific SEO and sharing title; overrides the site default without changing the visible page title. Null or an empty string clears the override and restores the site/automatic fallback."
              },
              "metaDescription": {
                "type": "string",
                "nullable": true,
                "description": "Page-specific meta and sharing description; overrides the site default. Null or an empty string clears the override and restores the site/automatic fallback."
              },
              "metaImage": {
                "type": "string",
                "nullable": true,
                "description": "Page-specific sharing image: HTTP(S) URL (re-hosted server-side) or an already-hosted filename, including translated images. Null or an empty string clears the override and restores the site/automatic fallback."
              }
            },
            "additionalProperties": true,
            "description": "Translated page fields, including SEO overrides. Other translated page content can also be present."
          },
          "en": {
            "type": "object",
            "nullable": true,
            "properties": {
              "metaTitle": {
                "type": "string",
                "nullable": true,
                "description": "Page-specific SEO and sharing title; overrides the site default without changing the visible page title. Null or an empty string clears the override and restores the site/automatic fallback."
              },
              "metaDescription": {
                "type": "string",
                "nullable": true,
                "description": "Page-specific meta and sharing description; overrides the site default. Null or an empty string clears the override and restores the site/automatic fallback."
              },
              "metaImage": {
                "type": "string",
                "nullable": true,
                "description": "Page-specific sharing image: HTTP(S) URL (re-hosted server-side) or an already-hosted filename, including translated images. Null or an empty string clears the override and restores the site/automatic fallback."
              }
            },
            "additionalProperties": true,
            "description": "Translated page fields, including SEO overrides. Other translated page content can also be present."
          },
          "he": {
            "type": "object",
            "nullable": true,
            "properties": {
              "metaTitle": {
                "type": "string",
                "nullable": true,
                "description": "Page-specific SEO and sharing title; overrides the site default without changing the visible page title. Null or an empty string clears the override and restores the site/automatic fallback."
              },
              "metaDescription": {
                "type": "string",
                "nullable": true,
                "description": "Page-specific meta and sharing description; overrides the site default. Null or an empty string clears the override and restores the site/automatic fallback."
              },
              "metaImage": {
                "type": "string",
                "nullable": true,
                "description": "Page-specific sharing image: HTTP(S) URL (re-hosted server-side) or an already-hosted filename, including translated images. Null or an empty string clears the override and restores the site/automatic fallback."
              }
            },
            "additionalProperties": true,
            "description": "Translated page fields, including SEO overrides. Other translated page content can also be present."
          },
          "it": {
            "type": "object",
            "nullable": true,
            "properties": {
              "metaTitle": {
                "type": "string",
                "nullable": true,
                "description": "Page-specific SEO and sharing title; overrides the site default without changing the visible page title. Null or an empty string clears the override and restores the site/automatic fallback."
              },
              "metaDescription": {
                "type": "string",
                "nullable": true,
                "description": "Page-specific meta and sharing description; overrides the site default. Null or an empty string clears the override and restores the site/automatic fallback."
              },
              "metaImage": {
                "type": "string",
                "nullable": true,
                "description": "Page-specific sharing image: HTTP(S) URL (re-hosted server-side) or an already-hosted filename, including translated images. Null or an empty string clears the override and restores the site/automatic fallback."
              }
            },
            "additionalProperties": true,
            "description": "Translated page fields, including SEO overrides. Other translated page content can also be present."
          },
          "ru": {
            "type": "object",
            "nullable": true,
            "properties": {
              "metaTitle": {
                "type": "string",
                "nullable": true,
                "description": "Page-specific SEO and sharing title; overrides the site default without changing the visible page title. Null or an empty string clears the override and restores the site/automatic fallback."
              },
              "metaDescription": {
                "type": "string",
                "nullable": true,
                "description": "Page-specific meta and sharing description; overrides the site default. Null or an empty string clears the override and restores the site/automatic fallback."
              },
              "metaImage": {
                "type": "string",
                "nullable": true,
                "description": "Page-specific sharing image: HTTP(S) URL (re-hosted server-side) or an already-hosted filename, including translated images. Null or an empty string clears the override and restores the site/automatic fallback."
              }
            },
            "additionalProperties": true,
            "description": "Translated page fields, including SEO overrides. Other translated page content can also be present."
          },
          "pt": {
            "type": "object",
            "nullable": true,
            "properties": {
              "metaTitle": {
                "type": "string",
                "nullable": true,
                "description": "Page-specific SEO and sharing title; overrides the site default without changing the visible page title. Null or an empty string clears the override and restores the site/automatic fallback."
              },
              "metaDescription": {
                "type": "string",
                "nullable": true,
                "description": "Page-specific meta and sharing description; overrides the site default. Null or an empty string clears the override and restores the site/automatic fallback."
              },
              "metaImage": {
                "type": "string",
                "nullable": true,
                "description": "Page-specific sharing image: HTTP(S) URL (re-hosted server-side) or an already-hosted filename, including translated images. Null or an empty string clears the override and restores the site/automatic fallback."
              }
            },
            "additionalProperties": true,
            "description": "Translated page fields, including SEO overrides. Other translated page content can also be present."
          },
          "de": {
            "type": "object",
            "nullable": true,
            "properties": {
              "metaTitle": {
                "type": "string",
                "nullable": true,
                "description": "Page-specific SEO and sharing title; overrides the site default without changing the visible page title. Null or an empty string clears the override and restores the site/automatic fallback."
              },
              "metaDescription": {
                "type": "string",
                "nullable": true,
                "description": "Page-specific meta and sharing description; overrides the site default. Null or an empty string clears the override and restores the site/automatic fallback."
              },
              "metaImage": {
                "type": "string",
                "nullable": true,
                "description": "Page-specific sharing image: HTTP(S) URL (re-hosted server-side) or an already-hosted filename, including translated images. Null or an empty string clears the override and restores the site/automatic fallback."
              }
            },
            "additionalProperties": true,
            "description": "Translated page fields, including SEO overrides. Other translated page content can also be present."
          },
          "es": {
            "type": "object",
            "nullable": true,
            "properties": {
              "metaTitle": {
                "type": "string",
                "nullable": true,
                "description": "Page-specific SEO and sharing title; overrides the site default without changing the visible page title. Null or an empty string clears the override and restores the site/automatic fallback."
              },
              "metaDescription": {
                "type": "string",
                "nullable": true,
                "description": "Page-specific meta and sharing description; overrides the site default. Null or an empty string clears the override and restores the site/automatic fallback."
              },
              "metaImage": {
                "type": "string",
                "nullable": true,
                "description": "Page-specific sharing image: HTTP(S) URL (re-hosted server-side) or an already-hosted filename, including translated images. Null or an empty string clears the override and restores the site/automatic fallback."
              }
            },
            "additionalProperties": true,
            "description": "Translated page fields, including SEO overrides. Other translated page content can also be present."
          },
          "gr": {
            "type": "object",
            "nullable": true,
            "properties": {
              "metaTitle": {
                "type": "string",
                "nullable": true,
                "description": "Page-specific SEO and sharing title; overrides the site default without changing the visible page title. Null or an empty string clears the override and restores the site/automatic fallback."
              },
              "metaDescription": {
                "type": "string",
                "nullable": true,
                "description": "Page-specific meta and sharing description; overrides the site default. Null or an empty string clears the override and restores the site/automatic fallback."
              },
              "metaImage": {
                "type": "string",
                "nullable": true,
                "description": "Page-specific sharing image: HTTP(S) URL (re-hosted server-side) or an already-hosted filename, including translated images. Null or an empty string clears the override and restores the site/automatic fallback."
              }
            },
            "additionalProperties": true,
            "description": "Translated page fields, including SEO overrides. Other translated page content can also be present."
          },
          "ro": {
            "type": "object",
            "nullable": true,
            "properties": {
              "metaTitle": {
                "type": "string",
                "nullable": true,
                "description": "Page-specific SEO and sharing title; overrides the site default without changing the visible page title. Null or an empty string clears the override and restores the site/automatic fallback."
              },
              "metaDescription": {
                "type": "string",
                "nullable": true,
                "description": "Page-specific meta and sharing description; overrides the site default. Null or an empty string clears the override and restores the site/automatic fallback."
              },
              "metaImage": {
                "type": "string",
                "nullable": true,
                "description": "Page-specific sharing image: HTTP(S) URL (re-hosted server-side) or an already-hosted filename, including translated images. Null or an empty string clears the override and restores the site/automatic fallback."
              }
            },
            "additionalProperties": true,
            "description": "Translated page fields, including SEO overrides. Other translated page content can also be present."
          },
          "route": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "URL path as slug segments (e.g. [\"infos\",\"horaires\"])."
          },
          "url": {
            "type": "string",
            "readOnly": true,
            "description": "Joined route (\"infos/horaires\"). Read-only convenience field."
          },
          "active": {
            "type": "boolean"
          },
          "html": {
            "type": "string",
            "description": "AI content HTML (with data-i18n attributes). Present on AI pages."
          },
          "mainLang": {
            "type": "string",
            "nullable": true,
            "description": "Default language of the HTML content."
          },
          "i18n": {
            "type": "object",
            "description": "Translations: { lang: { i18nKey: value } } for the data-i18n keys in the HTML.",
            "additionalProperties": true
          },
          "aiEditable": {
            "type": "boolean",
            "readOnly": true,
            "description": "Whether the page content can be written via PUT /pages/{id}/content (false for legacy visual-editor pages)."
          },
          "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": "Payload to create or edit a page's metadata and SEO (metaTitle/metaDescription/metaImage). A page created here is an AI page (its content can then be set via PUT /pages/{id}/content). On a partial PATCH only supplied fields change, including inside a language overlay. Editing SEO works on AI and legacy pages. The default language stays at the root; alternate enabled languages use overlays. SEO fields override site defaults independently; null/empty fields restore fallback. This is separate from HTML data-i18n translations.",
        "required": [
          "title",
          "url"
        ],
        "properties": {
          "label": {
            "type": "string",
            "description": "Internal label."
          },
          "title": {
            "type": "string",
            "description": "Public page title (required on create)."
          },
          "description": {
            "type": "string",
            "description": "Page description; automatic SEO fallback when no page/site SEO description is set."
          },
          "metaTitle": {
            "type": "string",
            "nullable": true,
            "description": "Page-specific SEO and sharing title; overrides the site default without changing the visible page title. Null or an empty string clears the override and restores the site/automatic fallback."
          },
          "metaDescription": {
            "type": "string",
            "nullable": true,
            "description": "Page-specific meta and sharing description; overrides the site default. Null or an empty string clears the override and restores the site/automatic fallback."
          },
          "metaImage": {
            "type": "string",
            "nullable": true,
            "description": "Page-specific sharing image: HTTP(S) URL (re-hosted server-side) or an already-hosted filename, including translated images. Null or an empty string clears the override and restores the site/automatic fallback."
          },
          "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": "Page URL, e.g. \"infos/horaires\" (required on create). Normalised server-side into slug segments; must be unique and not collide with a built-in page. The home page's URL cannot be changed."
          },
          "active": {
            "type": "boolean",
            "description": "Whether the page is published (default true)."
          }
        }
      },
      "PageSeoOverlay": {
        "type": "object",
        "nullable": true,
        "additionalProperties": false,
        "description": "Partial SEO translation for an enabled alternate language. The organisation's default language stays at the root. Only supplied fields change. Null or an empty object clears this language's SEO only, preserving its other translated page content; clearing stale SEO remains allowed after a language is disabled. Fields accept null/empty strings to restore fallback. Distinct from HTML i18n dictionaries.",
        "properties": {
          "metaTitle": {
            "type": "string",
            "nullable": true,
            "description": "Page-specific SEO and sharing title; overrides the site default without changing the visible page title. Null or an empty string clears the override and restores the site/automatic fallback."
          },
          "metaDescription": {
            "type": "string",
            "nullable": true,
            "description": "Page-specific meta and sharing description; overrides the site default. Null or an empty string clears the override and restores the site/automatic fallback."
          },
          "metaImage": {
            "type": "string",
            "nullable": true,
            "description": "Page-specific sharing image: HTTP(S) URL (re-hosted server-side) or an already-hosted filename, including translated images. Null or an empty string clears the override and restores the site/automatic fallback."
          }
        }
      },
      "PageUpdateInput": {
        "type": "object",
        "description": "Partial page metadata and SEO update. Only supplied fields change, including inside alternate-language SEO overlays; no field is required. Null/empty SEO fields restore site defaults, then automatic values. Default-language fields stay at the root.",
        "properties": {
          "label": {
            "type": "string",
            "description": "Internal label."
          },
          "title": {
            "type": "string",
            "description": "Public page title (required on create)."
          },
          "description": {
            "type": "string",
            "description": "Page description; automatic SEO fallback when no page/site SEO description is set."
          },
          "metaTitle": {
            "type": "string",
            "nullable": true,
            "description": "Page-specific SEO and sharing title; overrides the site default without changing the visible page title. Null or an empty string clears the override and restores the site/automatic fallback."
          },
          "metaDescription": {
            "type": "string",
            "nullable": true,
            "description": "Page-specific meta and sharing description; overrides the site default. Null or an empty string clears the override and restores the site/automatic fallback."
          },
          "metaImage": {
            "type": "string",
            "nullable": true,
            "description": "Page-specific sharing image: HTTP(S) URL (re-hosted server-side) or an already-hosted filename, including translated images. Null or an empty string clears the override and restores the site/automatic fallback."
          },
          "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": "Page URL, e.g. \"infos/horaires\" (required on create). Normalised server-side into slug segments; must be unique and not collide with a built-in page. The home page's URL cannot be changed."
          },
          "active": {
            "type": "boolean",
            "description": "Whether the page is published (default true)."
          }
        }
      },
      "PageContentInput": {
        "type": "object",
        "description": "HTML content for an AI page. Send PLAIN HTML — you do NOT manage translation keys yourself. The server post-processes the HTML and injects a `data-i18n=\"<key>\"` attribute on every translatable text node that lacks one (and `data-i18n-alt`/`-title`/`-placeholder`/`-aria-label` for those attributes), auto-generating keys like `auto_1`. The text in `mainLang` becomes the reference dictionary; existing translations for other languages are preserved and stale keys pruned. To translate, read the page back to get the keys, then POST /pages/{id}/translations with `{lang, dict:{key:value}}`. Refused with PAGE_CONTENT_NOT_EDITABLE on legacy pages.",
        "required": [
          "html"
        ],
        "properties": {
          "html": {
            "type": "string",
            "description": "The page HTML (a fragment or full document). data-i18n keys are added automatically."
          },
          "mainLang": {
            "type": "string",
            "description": "Language the HTML is written in (e.g. \"fr\"). Defaults to the page's current mainLang or the org default."
          },
          "assets": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Optional asset filenames referenced by the HTML."
          }
        }
      },
      "PageTranslationsInput": {
        "type": "object",
        "description": "Translations for one language of an AI page's existing data-i18n keys. Does not change the HTML. Read the page (its `i18n` + the `data-i18n` keys in `html`) to discover the keys.",
        "required": [
          "lang",
          "dict"
        ],
        "properties": {
          "lang": {
            "type": "string",
            "description": "Target language code (e.g. \"en\", \"he\")."
          },
          "dict": {
            "type": "object",
            "description": "{ i18nKey: translatedValue }.",
            "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"
      }
    }
  }
}
```
