Skip to content
Median
Esc
↑↓navigate↵open⌘Jpreview

Knowledge coverage

The library’s shape today, and what the review queue decided in the window.

GET/analytics/knowledge
Authorization
AuthorizationBearer token · headerrequired
`MEDIAN_KEY` from Settings under API, or an MCP OAuth access token. A key acts as the organization; a token acts as the person who approved it.
Query parameters
frominteger
The window's start, unix ms. Defaults to `days` ago.
daysinteger
Daily buckets after `from`. Default 30.
Allowed:73090
Responses
200The library and the window.
docsobject
Show properties
totalinteger
bySourceobject
indexinginteger
brokeninteger
reviewobject
Show properties
approvedinteger
dismissedinteger
pendinginteger
learnedinteger
400The request is malformed, and the message names the field.
errorobject
Show properties
codestring
messagestring
401The bearer token is missing, revoked, or expired.
errorobject
Show properties
codestring
messagestring
429Too many requests. Wait the seconds in `Retry-After`. Limits depend on the plan. See [rate limits](/api/errors-and-limits#rate-limits).
errorobject
Show properties
codestring
messagestring
Request
curl -X GET "https://api.median.sh/v1/analytics/knowledge" \
  -H "Authorization: Bearer YOUR_TOKEN"
Response
{
  "docs": {
    "total": 0,
    "bySource": {},
    "indexing": 0,
    "broken": 0
  },
  "review": {
    "approved": 0,
    "dismissed": 0,
    "pending": 0
  },
  "learned": 0
}