Servers

List interactions (the product unit replacing sessions) for a server, most-recent first. Served from ClickHouse raw events; counters are exact distinct event counts over the interaction's life within plan retention. Count sorts (tool calls, request errors, tool errors, or combined errors) and ascending sorts rank over the requested window, or over the most recent days that hold about 20M raw events (1-7, reported as sortWindowDays). A read stopped by its time or memory guard returns 503 with code INTERACTIONS_QUERY_LIMIT.

get/api/v1/servers/{id}/interactions

Request

  • Base URL: https://cloud.manufact.com
  • URL: https://cloud.manufact.com/api/v1/servers/{id}/interactions
  • Auth: none declared

Path parameters

idstring uuid required

Query parameters

branchstring
timeRange'24h' | '7d' | '30d' | '90d'
limitinteger
cursorstring
boolean
OR
'true' | 'false'
sortBy'lastSeen' | 'toolCalls' | 'errors' | 'requestErrors' | 'toolErrors'
sortDir'asc' | 'desc'
clientstring
clientsstring
countrystring
boolean
OR
'true' | 'false'
goalIdstring
goalIdsstring
outcome'achieved' | 'failed' | 'unknown'
outcomesstring
toolstring
toolsstring
actorIdstring
sessionIdstring
interactionIdsstring

Response

OK

nextCursorstring nullable required
truncatedboolean
sortWindowDaysinteger

Changes

No recorded changes to this operation across all 1 revision of this API.