Realiza una inserción o actualización de una variante de documento de un componente personalizado, indexada por el id del documento.
Realiza una operación de inserción o actualización de una variante (una fila de documents) de un componente personalizado, indexada por el id del documento. Proporciona id para actualizar una variante existente; omítelo para insertar una nueva. También está disponible en /schemas/{schema_name}. El contenido se valida con el esquema del componente.
Auth: clave de API — siempre obligatoria, y la clave debe incluir el permiso content_write.
| Parámetro | Tipo | Obligatorio | Notas |
|---|---|---|---|
schema_name | cadena | sí | El nombre del componente personalizado. |
| Parámetro | Tipo | Obligatorio | Notas |
|---|---|---|---|
websiteId | uuid | no | Sitio web de destino; recurre al encabezado Host o a la configuración. |
api_key | cadena | no | Alternativa al encabezado x-api-key. |
{
"id": "<uuid>",
"title": "Mi variante",
"content": { "title": "Hola", "body": "..." }
}
| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
id | uuid | no | Actualiza la variante coincidente cuando está presente; inserta cuando falta o no se encuentra. |
title | cadena | no | Título visible. Toma por defecto "Sin título" al insertar; se deja sin cambios en la actualización cuando se omite. |
content | objeto | sí | Valores de los campos, validados con el esquema del componente. Debe ser un objeto JSON. |
{
"id": "...",
"schema_name": "publicación",
"title": "Mi variante",
"status": "borrador",
"version": 2,
"created": true
}
created es true en una inserción (HTTP 201) y false en una actualización (HTTP 200).
curl -X PATCH '{CMS_API_URL}/dataset/post?websiteId=<uuid>' \
-H 'x-api-key: <key>' \
-H 'Content-Type: application/json' \
-d '{"content":{"title":"Hello"}}'
400 — websiteId inválido, content que no es un objeto, componente desconocido o archivado, o fallo de validación401 — falta la clave de API o es inválida403 — la clave no tiene el permiso content_write404 — se proporcionó id pero no hay una variante coincidente