Analíticas

Próxima versión — Zylon 1.58Esta documentación se publica antes del lanzamiento para que puedas preparar tus integraciones de API. La imagen de la versión todavía no está disponible. Para instalaciones con 1.57, consulta la documentación de 1.57.

Los endpoints de analíticas resumen cómo se usa el espacio de trabajo en proyectos y usuarios.

Solicitud básica y respuesta

Empieza con los totales desde GET /api/v1/app/organization/analytics/totals.

curl "https://{BASE_URL}/api/v1/app/organization/analytics/totals" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "x-org: {org_slug}"

Ejemplo de respuesta

{
  "projects_total": 12,
  "threads_total": 184,
  "interactions_total": 1420,
  "agent_flows_total": 36,
  "uploaded_artifacts_total": 87
}

Ranking de usuarios activos

Parametros del endpoint

Tipo	Nombre	Obligatorio	Notas
Query	`start_date`	No	Inicio del periodo como milisegundos desde Unix epoch.
Query	`end_date`	No	Fin del periodo como milisegundos desde Unix epoch.
Query	`limit`	No	Numero maximo de usuarios a devolver. Por defecto `5`.

curl "https://{BASE_URL}/api/v1/app/organization/analytics/ranking/active-users?start_date=1769990400000&end_date=1771804800000&limit=5" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "x-org: {org_slug}"

Ejemplo de respuesta

[
  {
    "account": {
      "id": "acct_6c8a1f3b2d4e5f7a",
      "state": "Active",
      "email": "sasha@example.com",
      "name": "Sasha Patel",
      "profile_picture": "https://{BASE_URL}/files/profile-picture.png",
      "provider": "Credentials",
      "roles": ["Workspace"],
      "created_at": "2026-02-08T14:12:45Z",
      "updated_at": "2026-02-08T14:12:45Z"
    },
    "interactions_created": 46,
    "agent_flows_created": 4
  }
]

Ranking de proyectos activos

Parametros del endpoint

Tipo	Nombre	Obligatorio	Notas
Query	`start_date`	No	Inicio del periodo como milisegundos desde Unix epoch.
Query	`end_date`	No	Fin del periodo como milisegundos desde Unix epoch.
Query	`limit`	No	Numero maximo de proyectos a devolver. Por defecto `5`.

curl "https://{BASE_URL}/api/v1/app/organization/analytics/ranking/active-projects?start_date=1769990400000&end_date=1771804800000&limit=5" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "x-org: {org_slug}"

Ejemplo de respuesta

[
  {
    "project": {
      "id": "proj_7a5c3e1b9d2f4a6c",
      "name": "Customer Insights",
      "goal": "Summarize weekly support trends.",
      "visibility": "Public",
      "default_member_role": "Editor",
      "default_role_enabled": true,
      "project_context": "Support analytics for Q1.",
      "use_citations": true,
      "use_system_prompt": true,
      "members": [
        {
          "id": "{wsMemberId}",
          "role": "Owner",
          "account": {
            "id": "acct_6c8a1f3b2d4e5f7a",
            "state": "Active",
            "email": "sasha@example.com",
            "name": "Sasha Patel",
            "provider": "Credentials",
            "roles": [
              "Workspace"
            ],
            "created_at": "2026-02-08T14:12:45Z",
            "updated_at": "2026-02-08T14:12:45Z"
          },
          "is_project_member": true
        }
      ],
      "is_pinned": false
    },
    "interactions_created": 112,
    "agent_flows_created": 12
  }
]

El proyecto anidado sigue el modelo de respuesta de Proyecto, incluidas las cuentas de miembros. Los campos nulos del proyecto pueden omitirse.

Serie de tiempo

Ambos limites de fecha son obligatorios. Los resultados son recuentos semanales en intervalos de siete dias desde la fecha inicial solicitada.

Parametros del endpoint

Tipo	Nombre	Obligatorio	Notas
Query	`start_date`	Si	Inicio del periodo como milisegundos desde Unix epoch.
Query	`end_date`	Si	Fin del periodo como milisegundos desde Unix epoch.
Query	`type`	Si	`Thread`, `Interactions`, `artifact_agent_flow` o `artifact_document`; no distingue mayusculas.

curl "https://{BASE_URL}/api/v1/app/organization/analytics/timeseries?start_date=1769990400000&end_date=1771804800000&type=interactions" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "x-org: {org_slug}"

Ejemplo de respuesta

[
  { "date": "2026-02-02", "value": 18 },
  { "date": "2026-02-09", "value": 25 },
  { "date": "2026-02-16", "value": 21 },
  { "date": "2026-02-23", "value": 19 }
]

Errores y casos límite

400: rango de fechas o tipo inválido.
403: permisos insuficientes.

Primeros pasos

Construye con Zylon

Coding Agents

Solicitud básica y respuesta

Ranking de usuarios activos

Ranking de proyectos activos

Serie de tiempo

Errores y casos límite

​Solicitud básica y respuesta

​Ranking de usuarios activos

​Ranking de proyectos activos

​Serie de tiempo

​Errores y casos límite

Solicitud básica y respuesta

Ranking de usuarios activos

Ranking de proyectos activos

Serie de tiempo

Errores y casos límite