---
title: "GetUsage"
method: POST
path: "/kythene.v1.KytheneService/GetUsage"
tags: ["kythene.v1.KytheneService"]
---

# GetUsage

`POST /kythene.v1.KytheneService/GetUsage`

## Request

- Base URL: `https://kythene.com` (the document declares no server; this is the origin it was published from)
- URL: `https://kythene.com/kythene.v1.KytheneService/GetUsage`
- Auth: none required

GetUsage returns how the workspace is being used over a window - recall
 volume and the zero-result rate, reads, publishes and curation effort - as
 aggregate counts. The machine-readable counterpart to the Usage page.

## Headers

- `Connect-Protocol-Version` 1, required: Define the version of the Connect protocol
- `Connect-Timeout-Ms` number: Define the timeout, in ms

## Request body

- KytheneV1GetUsageRequest
  - `days` integer: days is the window to report over (default 30, clamped to 1..365).
  - `space` string: space optionally selects which of your spaces to act in (an id or name from list_spaces). Omit it when you belong to a single space.

## Response `200`

Success

- KytheneV1GetUsageResponse
  - `days` integer: days is the window actually reported over.
  - `recalls` integer: recalls is the number of recalls in the window.
  - `zeroResultRecalls` integer: zero_result_recalls is how many returned nothing - the product-health canary.
  - `zeroResultRate` number, double: zero_result_rate is that as a percentage (0 when there were no recalls).
  - `recallsByCaller` object: recalls_by_caller splits recalls by caller kind (mcp / cli / web).
  - `reads` integer: reads is the number of work reads (collections/artifacts/memories).
  - `publishes` integer: publishes is the number of collections published.
  - `newVersions` integer: new_versions is the number of artifact versions pushed.
  - `comments` integer: comments is the number of comments left.
  - `approvals` integer: approvals / rejections are review decisions recorded.
  - `rejections` integer
  - `deprecations` integer: deprecations / promotions are memory-curation actions.
  - `promotions` integer

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/kythene/apis/kythene-v1.md) · [All operations](https://skmtc.dev/kythene/apis/kythene-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/kythene/apis/kythene-v1/revisions/5a768e642d10?raw)