Reten Docs
Activity Generation Configs

Listar Activity Generation Configs

Lista las activity generation configs del proyecto activo (solo metadatos).

GET /api/activity-generation-configs

Devuelve un arreglo con las activity generation configs del proyecto activo, de la más nueva a la más antigua. La lista no está paginada. Este endpoint devuelve solo metadatos — no incluye los pilares de ciclo de vida anidados ni los config hashes; cada ítem trae los nombres de sus tres pilares y su effectiveAudienceId.

Auth: Requerida — permiso activity-generation-config:view

configHashes y la configuración anidada completa (activationConfig, engagementConfig, resurrectionConfig) solo se devuelven en GET /:id. Usa este endpoint de listado para descubrir AGCs y luego obtén una por id para ver el detalle.

Parámetros de Query

ParámetroTipoPor defectoDescripción
statusdraft | active | paused—Devuelve sólo las AGC en ese estado. Sin él, se devuelven las AGC de todos los estados. Sólo las configuraciones active están pensadas para correr: lístalas con ?status=active

Ejemplo

curl "https://api.reten.ai/api/activity-generation-configs?status=active" \
  -H "Authorization: Bearer <token>" \
  -H "x-tenant-id: <tenant-id>" \
  -H "x-project-id: <project-id>"
import axios from 'axios';

const response = await axios.get(
  'https://api.reten.ai/api/activity-generation-configs',
  {
    params: { status: 'active' }, // opcional; sin él, todos los estados
    headers: { Authorization: 'Bearer <token>', 'x-tenant-id': '<tenant-id>', 'x-project-id': '<project-id>' },
  },
);
const configs = response.data;

Respuesta 200 OK

[
  {
    "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "projectId": "3f6c2b1a-8d4e-4f7a-9b2c-5e1d0a7f6c34",
    "name": "Default lifecycle",
    "description": "Activation, engagement and resurrection for the main funnel",
    "audienceId": null,
    "status": "active",
    "updatedBy": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "createdAt": "2026-06-10T14:00:00.000Z",
    "updatedAt": "2026-06-15T09:30:00.000Z",
    "activationConfigName": "Activation",
    "engagementConfigName": "Engagement",
    "resurrectionConfigName": "Resurrection",
    "effectiveAudienceId": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d"
  },
  {
    "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
    "projectId": "3f6c2b1a-8d4e-4f7a-9b2c-5e1d0a7f6c34",
    "name": "Premium cohort lifecycle",
    "description": null,
    "audienceId": "1f0d2c3b-4a59-4687-9c12-abcdef012345",
    "status": "active",
    "updatedBy": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "createdAt": "2026-06-02T08:15:00.000Z",
    "updatedAt": "2026-06-12T17:40:00.000Z",
    "activationConfigName": "Premium activation",
    "engagementConfigName": "Premium engagement",
    "resurrectionConfigName": "Premium resurrection",
    "effectiveAudienceId": "1f0d2c3b-4a59-4687-9c12-abcdef012345"
  }
]

effectiveAudienceId es audienceId cuando la AGC tiene audiencia propia, y la audiencia raíz del proyecto en caso contrario — ver Audiencia efectiva. Nunca es null.

Respuestas de Error

EstadoDescripción
400status no es uno de draft, active, paused