Git.Top Health API
The Health API from Git.Top — 1 operation(s) for health.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/git-top:git-top-health-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Git.Top Agent Health API
version: 0.1.0
description: Agent-native GitHub project knowledge API for search, project lookup, alternatives, comparison, graph reasoning, quality, and schema discovery. High-confidence clients should inspect metadata.source, metadata.reason, trust fields, classification evidence, quality_signal_confidence, verification signals, and migration validation steps, and use require_d1=true when seed fallback should fail closed.
servers:
- url: https://git.top
description: Production
- url: http://localhost:8787
description: Local Worker
tags:
- name: Health
paths:
/api/health:
get:
summary: Inspect D1 availability, project counts, and sync freshness
responses:
'200':
description: Health response
content:
application/json:
schema:
$ref: '#/components/schemas/HealthResponse'
example:
ok: true
db: available
project_count: 500
raw_project_count: 500
knowledge_ready_project_count: 500
sync_health: healthy
sync_freshness: fresh
last_successful_sync_at: '2026-07-04T00:00:00.000Z'
hours_since_successful_sync: 1
operational_storage:
status: healthy
github_cache_entries: 1200
github_cache_body_bytes: 32000000
github_cache_max_entries: 2500
github_cache_retention_entries: 1500
github_cache_body_budget_bytes: 163840000
utilization: 0.48
star_snapshot_count: 500
sync_run_count: 120
governance_run_count: 40
metadata:
source: d1
reason: d1_query
project_count: 500
generated_at: '2026-07-04T00:00:00.000Z'
snapshot_id: d1:500:2026-07-04T00:00:00.000Z
latest_synced_at: '2026-07-04T00:00:00.000Z'
schema_version: git-top.knowledge.v1
tags:
- Health
operationId: getApiHealth
x-operation-id-source: derived
components:
schemas:
HealthResponse:
type: object
description: Health and source-preflight response. Agents should inspect db, metadata.source, sync_freshness, and project counts before trusting recommendations.
required:
- ok
- db
- project_count
- raw_project_count
- knowledge_ready_project_count
- sync_health
- sync_freshness
- metadata
properties:
ok:
type: boolean
db:
type: string
enum:
- available
- missing
- error
project_count:
type: integer
raw_project_count:
type: integer
knowledge_ready_project_count:
type: integer
sync_health:
type: string
sync_freshness:
type: string
last_successful_sync_at:
type:
- string
- 'null'
format: date-time
hours_since_successful_sync:
type:
- number
- 'null'
operational_storage:
type: object
properties:
status:
type: string
enum:
- healthy
- warning
- critical
- unknown
github_cache_entries:
type: integer
github_cache_body_bytes:
type: integer
github_cache_max_entries:
type: integer
github_cache_retention_entries:
type: integer
github_cache_body_budget_bytes:
type: integer
utilization:
type: number
star_snapshot_count:
type: integer
sync_run_count:
type: integer
governance_run_count:
type: integer
project_change_count:
type: integer
feedback_proposal_count:
type: integer
metadata:
$ref: '#/components/schemas/Metadata'
additionalProperties: true
Metadata:
type: object
description: Common provenance envelope for agent-facing responses. Agents should require source=d1 for high-confidence production claims and disclose seed fallback.
properties:
source:
type: string
enum:
- d1
- seed
reason:
type: string
project_count:
type: integer
generated_at:
type: string
format: date-time
snapshot_id:
type: string
description: Stable identity for the corpus snapshot used by this response.
latest_synced_at:
type:
- string
- 'null'
format: date-time
schema_version:
type: string
enum:
- git-top.knowledge.v1
loaded_project_limit:
type: integer
description: Maximum D1 knowledge or search-candidate rows loaded into the bounded ranking set when present.
truncated:
type: boolean
description: Whether the D1-backed ranking or candidate set reached its limit and may omit additional matching rows.
candidate_retrieval:
type: string
enum:
- d1_first
description: Search-only marker indicating that deterministic filters and broad query matching ran in D1 before TypeScript ranking.
candidate_count:
type: integer
description: Number of D1 search candidates passed to the authoritative TypeScript filter and ranking stage.
candidate_limit:
type: integer
description: Maximum number of D1 search candidates passed to the ranking stage.
warnings:
type: array
items:
type: string
description: Fallback, count, freshness, or trust caveats that agents should account for before citing results.
securitySchemes:
syncSecret:
type: http
scheme: bearer
description: Admin endpoints require the SYNC_SECRET bearer token.
feedbackSecret:
type: http
scheme: bearer
description: Optional FEEDBACK_SECRET. Without it, proposals are validated and fingerprinted but not persisted.