v1

latestOpenAPI 3.1.0MIT2026-07-26134154266.9 KB

Get usage counts for a resource

Aggregate usage for a given action, instruction, or KB item: distinct sessions and total replies where it was applied, the available counterpart (for instructions, to compute apply-rate), and first/last-used timestamps. Optionally bound by a date range.

get/resource-usage/{resource_type}/{resource_id}/usage-summary

Path parameters

resource_type'action' | 'instruction' | 'knowledge' required
resource_idstring required

Query parameters

{"stackTrail":"paths:/resource-usage/{resource_type}/{resource_id}/usage-summary:get:parameters:0:schema","oasType":"schema","type":"unknown"}
{"stackTrail":"paths:/resource-usage/{resource_type}/{resource_id}/usage-summary:get:parameters:1:schema","oasType":"schema","type":"unknown"}

Response

Default Response

session_countnumber required

Distinct conversations that used this resource

applied_sessionsnumber required

Distinct conversations where the resource was applied

applied_repliesnumber required

Total applications/invocations

available_sessionsnumber required

Distinct conversations where an instruction was in context (instructions only)

available_repliesnumber required
first_used_atstring nullable required

ISO 8601 timestamp of first use

last_used_atstring nullable required

ISO 8601 timestamp of most recent use