Activity Generation Configs
Actualizar Activity Generation Config
Actualiza solo los metadatos de una activity generation config.
PATCH /api/activity-generation-configs/:id
Actualiza solo los metadatos de una AGC. Este endpoint nunca toca los pilares de ciclo de vida — para cambiar activation, engagement o resurrection, usa PUT /:id/lifecycle.
Auth: Requerida — permiso activity-generation-config:update
Parámetros de Ruta
| Parámetro | Tipo | Descripción |
|---|---|---|
id | UUID | ID de la activity generation config |
Cuerpo de la Solicitud
Todos los campos son opcionales; solo se actualizan los campos que envías. Los cuerpos de solicitud son snake_case.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
name | string | No | Nombre de la config |
description | string | No | Descripción de texto libre |
audience_id | UUID | No | Audiencia a la que aplica esta config |
query_filter_id | UUID | No | Filtro de consulta guardado que delimita la población |
Los datos de los pilares de ciclo de vida no pueden cambiarse aquí. Este endpoint solo edita los campos de metadatos propios de la AGC.
Ejemplo
curl -X PATCH https://api.reten.ai/api/activity-generation-configs/f47ac10b-58cc-4372-a567-0e02b2c3d479 \
-H "Authorization: Bearer <token>" \
-H "x-tenant-id: <tenant-id>" \
-H "Content-Type: application/json" \
-d '{ "name": "Main funnel lifecycle", "description": "Renamed for clarity" }'import axios from 'axios';
const id = 'f47ac10b-58cc-4372-a567-0e02b2c3d479';
const response = await axios.patch(
`https://api.reten.ai/api/activity-generation-configs/${id}`,
{ name: 'Main funnel lifecycle', description: 'Renamed for clarity' },
{ headers: { Authorization: 'Bearer <token>', 'x-tenant-id': '<tenant-id>' } },
);
const updated = response.data;Respuesta 200 OK
Devuelve la AGC actualizada.
{
"id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"name": "Main funnel lifecycle",
"description": "Renamed for clarity",
"audienceId": "1f0d2c3b-4a59-4687-9c12-abcdef012345",
"queryFilterId": null,
"updatedBy": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"createdAt": "2026-06-10T14:00:00.000Z",
"updatedAt": "2026-06-17T11:05:00.000Z"
}Respuestas de Error
| Estado | Descripción |
|---|---|
400 | Validación fallida |
404 | Activity generation config no encontrada |