Logs

View as Markdown
Business request-log list with pagination metadata. **Time window — provide one of:** - `dateFrom` + `dateTo` (`YYYY-MM-DD`), or - `start` + `end` (ISO 8601 datetimes). If **both** pairs are present, the **ISO** `start`/`end` pair wins. **Filters:** at most one of `agentId` vs `memberId`; do not combine `entityType` with agent/member ids (`40028`). `entityType` ∈ `agent` | `user` | `member` (`member` maps to user internally). `search` non-empty must be UUID (`40027`). `masterKeyId` / `departmentId` optional UUIDs. **Pagination:** `limit` (default 20, max 200), `offset` **or** `page` + optional `pageSize`. **Success `data`:** `{ "period", "data": [...], "meta": { "total", "hasMore", "limit", "offset", ... } }`

Headers

AuthorizationstringOptional

Optional. Bearer JWT, Virtual Key, or PAT. Server also accepts Cookie alephant_token; not modeled as a header here.

X-Workspace-IdstringOptional

Optional in the spec; required for authenticated analytics. Omit for unauthenticated GET /v1/analytics/health.

Query parameters

dateFromstringOptional

Calendar start YYYY-MM-DD (use with dateTo unless ISO pair used).

dateTostringOptional

Calendar end YYYY-MM-DD.

startstringOptional

ISO 8601 start (pair with end; overrides calendar pair when both pairs present).

endstringOptional

ISO 8601 end; must be after start.

agentIdstringOptional

Agent UUID; mutually exclusive with memberId.

memberIdstringOptional

Member UUID; mutually exclusive with agentId.

entityTypestringOptional

agent | user | member for type-only filter; not with agentId/memberId.

masterKeyIdstringOptional
Optional master key UUID.
departmentIdstringOptional
Optional department UUID.
searchstringOptional

Non-empty must be UUID (entity/user id search).

modelstringOptional
Exact model filter after trim.
limitintegerOptional

Page size (default 20, max 200).

offsetintegerOptional

0-based offset (alternative to page).

pageintegerOptional

1-based page index when not using offset.

pageSizeintegerOptional

Used with page (capped with limit semantics, max 200).

statusstringOptional
HTTP status filter as integer string.

Response

codeinteger
messagestring
dataany