Skip to main content
POST
Crea una página

Autorizaciones

Authorization
string
header
requerido

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.

Cuerpo

application/json
name
string

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.

Maximum string length: 80
kind
enum<string>

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.

Opciones disponibles:
agent,
document
agentId
string

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
object

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.

path
string

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.

Maximum string length: 200
defaultLocale
enum<string>

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.

Opciones disponibles:
es,
en
projectId
string

El sitio (proyecto) dentro del cual se crea esta página. Opcional solo mientras el espacio de trabajo tenga exactamente uno; obligatorio con varios.

Respuesta

id
string
requerido
name
string
requerido
kind
enum<string>
requerido

agent o document (D-47).

Opciones disponibles:
agent,
document
path
string
requerido

La dirección bajo el host del sitio. / es la página principal.

status
string
requerido

draft o published.

defaultLocale
enum<string>
requerido
Opciones disponibles:
es,
en
editorial
object
requerido

El encuadre escrito por el dueño (página de agente). Vacío para un documento.

seo
object
requerido
sitemap
object
requerido
body
object
requerido

El markdown de una página de documento. Vacío para una página de agente.

createdAt
string<date-time>
requerido
updatedAt
string<date-time>
requerido
agentId
string

El cerebro que responde aquí. Ausente para una página de documento.

projectId
string

El sitio (proyecto) en el que vive la página.

publishedAt
string<date-time>