Query entities (agents or objects) across activities

Examples:

Find all sales agents

{ “entity_type”: “agent”, “tags”: [“sales”], “include_stats”: true }

Find documents involved in approved deals

{ “entity_type”: “object”, “kinds”: [“document”, “contract”], “outcomes”: [“approved”], “include_stats”: true }

Find active users in last 7 days

{ “entity_type”: “agent”, “kinds”: [“user”], “time”: {“last”: “7d”}, “min_activities”: 5, “include_stats”: true }

Find cross-functional agents (sales + engineering)

{ “entity_type”: “agent”, “tags”: [“sales”, “engineering”], “group_by”: “kind” }

Query entities (agents or objects) across activities Examples: # Find all sales agents { "entity_type": "agent", "tags": ["sales"], "include_stats": true } # Find documents involved in approved deals { "entity_type": "object", "kinds": ["document", "contract"], "outcomes": ["approved"], "include_stats": true } # Find active users in last 7 days { "entity_type": "agent", "kinds": ["user"], "time": {"last": "7d"}, "min_activities": 5, "include_stats": true } # Find cross-functional agents (sales + engineering) { "entity_type": "agent", "tags": ["sales", "engineering"], "group_by": "kind" }

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

entity_typestringOptionalDefaults to agent

'agent' or 'object'

activity_filtersmap from strings to any or nullOptional

Filter activities that entities appear in

tagslist of strings or nullOptional

Activities must have these tags

outcomeslist of strings or nullOptional

Activities must have these outcomes

actionslist of strings or nullOptional

Activities must have these actions

timemap from strings to any or nullOptional

Time range for activities

kindslist of strings or nullOptional

Entity kinds to include (user, team, document, etc)

roleslist of strings or nullOptional

Entity roles to include

current_statebooleanOptionalDefaults to false

Return only current state via quantum collapse

include_statsbooleanOptionalDefaults to false

Include activity statistics for each entity

group_bystring or nullOptional

Group entities by field (kind, role)

limitintegerOptional>=1<=1000Defaults to 100

min_activitiesintegerOptional>=1Defaults to 1

Minimum activities for entity to be included

Response

Successful Response

Errors