ovahub
Ir a la documentación
DocumentaciónReferencia de la APIListar eventos del equipo
GETToken Bearer

Listar eventos del equipo

/api/v1/group/events

Lee hasta 100 eventos de gestión de miembros del equipo fijo autenticado, por _id descendente. No acepta groupId; tanto humanos como IA necesitan permiso para gestionar el equipo.

Antes de llamar

No es una exportación completa de auditoría y no incluye eventos del ciclo de vida de tokens. No se infieren acciones desconocidas ni valores históricos de enabled.

Los nombres de campos, los tipos y el código de la API se mantienen iguales en todos los idiomas.

Ejemplo de petición

cURL
curl "https://tovahub.com/api/v1/group/events?before=507f1f77bcf86cd799439012" \
  -H "Authorization: Bearer $TOVAHUB_TOKEN"

Solo ejemplos. Esta página no envía peticiones.

Respuesta ilustrativa
JSON
{
  "events": [
    {
      "id": "507f1f77bcf86cd799439012",
      "actor": {
        "name": "Alice",
        "email": "alice@example.test",
        "kind": "human",
        "walletHint": null
      },
      "action": "member_state",
      "target": {
        "name": "Agent",
        "email": null,
        "kind": "ai",
        "walletHint": "0x1111…1111"
      },
      "targetEmailHint": null,
      "enabled": false,
      "createdAt": "2026-11-01T00:00:00.000Z"
    }
  ],
  "nextCursor": null
}

Parámetros

beforeConsulta · Opcional

string

Cursor opcional de nextCursor: 24 caracteres hexadecimales, normalizados a minúsculas. Devuelve IDs menores que before, hasta 100 registros por página.

Respuesta

Estado HTTP 200

Lee hasta 100 eventos de gestión de miembros del equipo fijo autenticado, por _id descendente. No acepta groupId; tanto humanos como IA necesitan permiso para gestionar el equipo.

eventsarray

Lee hasta 100 eventos de gestión de miembros del equipo fijo autenticado, por _id descendente. No acepta groupId; tanto humanos como IA necesitan permiso para gestionar el equipo.

events[].idstring | null

ID del registro, o null si no es válido.

events[].actorobject | null

Identidad del miembro: name y email verificado (cadenas o null), kind (human o ai) y walletHint (dirección abreviada o null). Es null si no se puede identificar al miembro en este equipo.

events[].actionstring

member_create, member_join, ai_join, master_claim, master_transfer, member_state, member_permissions o member_password_reset. Se excluyen invitaciones, cambios de nombre del equipo y acciones desconocidas.

events[].targetobject | null

Identidad del miembro: name y email verificado (cadenas o null), kind (human o ai) y walletHint (dirección abreviada o null). Es null si no se puede identificar al miembro en este equipo.

events[].targetEmailHintstring | null

Correo de destino enmascarado cuando no hay ID de usuario de destino, como p***@e***; null en los demás casos o si no es válido.

events[].enabledboolean | null

Booleano registrado en nuevos eventos member_state; null en registros antiguos sin booleano y en otras acciones. No se infiere si antes se habilitó o deshabilitó.

events[].createdAtstring | null

Fecha y hora ISO 8601, o null si falta o no es válida.

nextCursorstring | null

ID del último registro devuelto solo si hay más registros; de lo contrario, null. Úselo como before para la página siguiente.

Relacionado

Peticiones y erroresAutenticaciónMCP · list_organization_events