> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zylon.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Analíticas

> Mide totales, rankings y series temporales.

<Warning>
  **Próxima versión — Zylon 1.58**

  Esta 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](/es/v1.57/overview).
</Warning>

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`.

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

<Accordion title="Ejemplo de respuesta">
  ```json theme={null}
  {
    "projects_total": 12,
    "threads_total": 184,
    "interactions_total": 1420,
    "agent_flows_total": 36,
    "uploaded_artifacts_total": 87
  }
  ```
</Accordion>

## Ranking de usuarios activos

<Accordion title="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`. |
</Accordion>

```bash theme={null}
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}"
```

<Accordion title="Ejemplo de respuesta">
  ```json theme={null}
  [
    {
      "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
    }
  ]
  ```
</Accordion>

## Ranking de proyectos activos

<Accordion title="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`. |
</Accordion>

```bash theme={null}
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}"
```

<Accordion title="Ejemplo de respuesta">
  ```json theme={null}
  [
    {
      "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
    }
  ]
  ```
</Accordion>

El proyecto anidado sigue el [modelo de respuesta de Proyecto](/es/v1.58/developer-manual/build-with-zylon/workspace-api/projects/project#campos-de-respuesta-del-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.

<Accordion title="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. |
</Accordion>

```bash theme={null}
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}"
```

<Accordion title="Ejemplo de respuesta">
  ```json theme={null}
  [
    { "date": "2026-02-02", "value": 18 },
    { "date": "2026-02-09", "value": 25 },
    { "date": "2026-02-16", "value": 21 },
    { "date": "2026-02-23", "value": 19 }
  ]
  ```
</Accordion>

## Errores y casos límite

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.