> ## Documentation Index > Fetch the complete documentation index at: https://wondeya.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Crea una página > Nace como BORRADOR: no le responde a nadie hasta `POST :id/publish`. Una página `agent` (por defecto) necesita un agente; una página `document` (D-47) renderiza un cuerpo markdown subido. ## OpenAPI ````yaml /openapi.es.json post /v1/pages openapi: 3.0.0 info: title: API para desarrolladores de wondeya description: >- La API REST pública para construir sobre wondeya: agentes, proyectos, páginas, conocimiento, recursos, marca, tema, uso, recuperación y chat, autenticada mediante una clave de API del espacio de trabajo (`Authorization: Bearer wdy_live_…`). version: 0.1.0 contact: name: wondeya url: https://wondeya.com email: team@wondeya.com license: name: Proprietary url: https://wondeya.com/terms servers: - url: https://api.wondeya.com description: Producción - url: http://localhost:8080 description: Desarrollo security: [] tags: - name: Identity - name: Agents - name: Projects - name: Pages - name: Knowledge - name: Assets - name: Brand - name: Usage - name: Chat paths: /v1/pages: post: tags: - Pages summary: Crea una página description: >- Nace como BORRADOR: no le responde a nadie hasta `POST :id/publish`. Una página `agent` (por defecto) necesita un agente; una página `document` (D-47) renderiza un cuerpo markdown subido. operationId: PublicPagesController_create_v1 parameters: [] requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreatePublicPageDto' responses: '201': description: '' content: application/json: schema: $ref: '#/components/schemas/PublicPageDto' '402': description: '`wondeya.billing.limit_reached`: el plan alcanzó su tope de páginas' security: - api-key: [] components: schemas: CreatePublicPageDto: type: object properties: name: type: string maxLength: 80 description: >- Opcional al crear (C10): una página puede nacer como un borrador mínimo solo a partir de su tipo y nombrarse en su pantalla de ajustes. Publicar no requiere un nombre; la consola muestra un placeholder para un borrador sin nombre. kind: type: string enum: - agent - document description: >- Qué es la página (D-47). `agent` (por defecto) es una página conversacional con un agente y contenido editorial; `document` renderiza un `body` markdown subido y no admite agente ni contenido editorial. agentId: type: string description: >- El agente que responde en esta página. Opcional: un borrador puede dejarlo sin definir (se asigna automáticamente cuando el espacio de trabajo tiene exactamente un agente), pero publicar una página `agent` requiere uno. Una página `document` no tiene ninguno. body: description: >- El markdown de una página `document` (D-47), por idioma. Opcional al crear (un borrador de documento puede empezar vacío; publicar requiere el idioma fuente); ausente para una página `agent`. allOf: - $ref: '#/components/schemas/PageBodyDto' path: type: string maxLength: 200 description: >- La dirección bajo el host del espacio de trabajo. `/` es la página principal, y exactamente una página por espacio de trabajo la tiene. De lo contrario, hasta 4 segmentos de letras, dígitos y guiones simples (`/pymes`, `/enterprise/latam`). No distingue mayúsculas de minúsculas y se almacena en minúsculas. Nunca codificada en porcentaje, nunca un segmento de punto. Reservados por la plataforma (y todo su subárbol): admin, api, app, cdn, console, docs, embed, mail, status, storage, well-known, widget, www. Su valor predeterminado es `/` cuando aún nada sirve la página principal, y de lo contrario una ruta derivada del nombre. defaultLocale: type: string enum: - es - en description: >- El idioma en el que el propietario escribe esta página (D-44). Debe ser uno que el SITIO sirva; por defecto es el idioma de origen del proyecto. Qué idiomas se SIRVEN es una configuración del proyecto. projectId: type: string description: >- El sitio (proyecto) dentro del cual se crea esta página. Opcional solo mientras el espacio de trabajo tenga exactamente uno; obligatorio con varios. PublicPageDto: type: object properties: id: type: string name: type: string kind: type: string enum: - agent - document description: '`agent` o `document` (D-47).' path: type: string description: La dirección bajo el host del sitio. `/` es la página principal. status: type: string description: '`draft` o `published`.' agentId: type: string description: El cerebro que responde aquí. Ausente para una página de documento. projectId: type: string description: El sitio (proyecto) en el que vive la página. defaultLocale: type: string enum: - es - en editorial: description: >- El encuadre escrito por el dueño (página de agente). Vacío para un documento. allOf: - $ref: '#/components/schemas/PublicPageEditorialDto' seo: $ref: '#/components/schemas/PublicPageSeoDto' sitemap: $ref: '#/components/schemas/PublicPageSitemapDto' body: description: >- El markdown de una página de documento. Vacío para una página de agente. allOf: - $ref: '#/components/schemas/PublicLocalizedTextDto' publishedAt: type: string format: date-time createdAt: type: string format: date-time updatedAt: type: string format: date-time required: - id - name - kind - path - status - defaultLocale - editorial - seo - sitemap - body - createdAt - updatedAt PageBodyDto: type: object properties: es: type: string description: Markdown en español. en: type: string description: Markdown en inglés. PublicPageEditorialDto: type: object properties: badge: $ref: '#/components/schemas/PublicLocalizedTextDto' title: $ref: '#/components/schemas/PublicLocalizedTextDto' titleAccent: $ref: '#/components/schemas/PublicLocalizedTextDto' description: $ref: '#/components/schemas/PublicLocalizedTextDto' required: - badge - title - titleAccent - description PublicPageSeoDto: type: object properties: title: $ref: '#/components/schemas/PublicLocalizedTextDto' description: $ref: '#/components/schemas/PublicLocalizedTextDto' required: - title - description PublicPageSitemapDto: type: object properties: priority: type: number minimum: 0 maximum: 1 changefreq: type: string enum: - always - hourly - daily - weekly - monthly - yearly - never sitemapExclude: type: boolean description: Mantén la página FUERA del sitemap. PublicLocalizedTextDto: type: object properties: es: type: string en: type: string securitySchemes: api-key: scheme: bearer bearerFormat: opaque type: http description: >- Una clave de API del espacio de trabajo: wdy_live_… / wdy_test_…. Se crea en POST /workspaces/{tenantId}/keys y se muestra exactamente una vez. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.