Skip to main content
GET
/
events
/
user
/
entity
/
{entityId}
/
has-events
Tem eventos? (por entidade)
curl --request GET \
  --url http://api.gu1.ai/events/user/entity/{entityId}/has-events \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "hasEvents": true,
  "entityId": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.gu1.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Visão geral

Use este endpoint quando você só precisa saber se uma entidade tem eventos de usuário (badges na UI, visibilidade de abas, pré-checagens), não a linha do tempo completa. Usa o mesmo escopo de vínculo que Listar por entidade: entity_id, entity_external_id ou tax_id na sua organização.
Prefira este endpoint em vez de listar com limit=1 quando só precisar de sim/não — evita COUNT(*), ordenação e serializar payloads de eventos.

​
Desempenho

Projetado para baixa latência:
AspectoComportamento
ConsultasDuas idas: entidade por UUID (PK) + uma sonda LIMIT 1 em user_events
Não fazCOUNT(*), ORDER BY, paginação nem colunas completas de evento/metadata
Índicesorganization_id + entity_id usa idx_user_events_organization_entity_id; entity_external_id e tax_id têm índices dedicados nas ramas do OR
A latência típica é dominada por rede e autenticação, não por varrer históricos grandes.

​
Endpoint

GET https://api.gu1.ai/events/user/entity/{entityId}/has-events

​
Autenticação

Requer API key válida no header Authorization: 
Authorization: Bearer YOUR_API_KEY

​
Parâmetros de rota

​
entityId
string
required
UUID da entidade a verificar

​
Resposta

​
success
boolean
Indica se a requisição foi bem-sucedida
​
hasEvents
boolean
true se existir pelo menos um evento vinculado (mesmo escopo de listar por entidade); caso contrário false
​
entityId
string
UUID da entidade confirmada

​
Exemplo — com eventos

{
  "success": true,
  "hasEvents": true,
  "entityId": "550e8400-e29b-41d4-a716-446655440000"
}

​
Exemplo — sem eventos

{
  "success": true,
  "hasEvents": false,
  "entityId": "550e8400-e29b-41d4-a716-446655440000"
}

​
Erros

StatusCódigoQuando
404ENTITY_NOT_FOUNDEntidade inexistente na org ou soft-deleted
401—API key ausente ou inválida
403—Permissões insuficientes (events:read)

​
Exemplos

curl "https://api.gu1.ai/events/user/entity/550e8400-e29b-41d4-a716-446655440000/has-events" \
  -H "Authorization: Bearer YOUR_API_KEY"

const entityId = '550e8400-e29b-41d4-a716-446655440000';
const res = await fetch(
  `https://api.gu1.ai/events/user/entity/${entityId}/has-events`,
  { headers: { Authorization: `Bearer ${API_KEY}` } }
);
const { hasEvents } = await res.json();
if (hasEvents) {
  const timeline = await fetch(
    `https://api.gu1.ai/events/user/entity/${entityId}?limit=50`,
    { headers: { Authorization: `Bearer ${API_KEY}` } }
  );
}

​
Próximos passos

Listar por entidade

Linha do tempo completa quando hasEvents for true

Listar eventos

Consultar com filtros

Estatísticas

Contagens por tipo de evento

Overview

Overview de eventos de usuário