POST
/api/mod/landing/{espacio}/landings/{landing}/refinarPide cambios a una landing
Crea una versión nueva sobre la última que tiene HTML, con la instrucción que le des. Las anteriores se conservan: puedes volver a cualquiera con ?version=.
- PERMISOescribe
- CRÉDITOSgasta créditos
- AUTENTICACIÓNBearer bth_…
PARÁMETROS
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| espacio | string | SÍ | El id del espacio (sale en GET /api/companies). Tiene que tener el módulo Landings. |
| landing | string | SÍ | El id de la landing: el que devolvió crearla (32 caracteres hexadecimales). |
CUERPO · JSON
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| prompt | string | SÍ | Qué cambiar, en texto libre. Hasta 24 000 caracteres. |
| brandBlock | string | no | Tu marca, en texto: nombre, colores, tipografías, tono, URL del logotipo. Hasta 20 000 caracteres. |
| formConfig | object | no | El formulario: campos, mensaje de éxito, botones y redirección. Su forma, en la guía. |
| chatHistory | [{ role, content }] | no | La conversación con tu usuario que llevó a esta petición, si la hay. Hasta 50 mensajes de 8000 caracteres. |
RESPUESTA 202
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| id | string | El id de la landing. |
| version | integer | El número de la versión que se encoló. |
| trabajo | string | El id de esa versión. Para seguirla te basta con id y version. |
| status | "pendiente" | Siempre pendiente al encolar. |
| base | integer | La versión sobre la que trabaja. |
ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}
| STATUS | CUÁNDO | DETAIL LITERAL |
|---|---|---|
| 403 | El espacio no tiene el módulo Landings | módulo no habilitado para este espacio. |
| 403 | La clave es de solo lectura | Tu cuenta es de solo lectura en este espacio. |
| 402 | La cuenta agotó sus créditos del ciclo | La cuenta de este espacio agotó sus créditos de este ciclo. |
| 404 | No hay una landing con ese id en el espacio (o se borró) | La landing no existe |
| 409 | La landing ya tiene una versión en curso: espera o cancélala | La landing ya tiene una versión en curso. |
| 409 | Ninguna versión tiene HTML todavía | La landing todavía no tiene una versión sobre la que trabajar. |
| 422 | Falta prompt | prompt es obligatorio |
| 429 | El espacio tiene demasiadas landings generándose a la vez | Hay demasiadas landings en curso en este espacio; espera a que terminen. |
Y los de cualquier ruta —clave inválida, cuenta no al día, IP, límites—, en Errores, límites y créditos.
CONVIENE SABER
- Retoca sin reescribir: cambia lo que pides y deja el resto. La versión nueva pasa otra vez por las dos revisiones.
- Refinar no revisa el brief: no pasa por
esperando_datos. Si el cambio trae datos nuevos, ponlos en elprompt. - Responde enseguida: el trabajo sigue en segundo plano y suele tardar unos minutos. Sigue la versión con GET landings/{landing}.