Reten Docs
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ámetroTipoDescripción
idUUIDID 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.

CampoTipoRequeridoDescripción
namestringNoNombre de la config
descriptionstringNoDescripción de texto libre
audience_idUUIDNoAudiencia a la que aplica esta config
query_filter_idUUIDNoFiltro 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

EstadoDescripción
400Validación fallida
404Activity generation config no encontrada