Git.Top · Schema
WorkflowResponse
Guided agent workflow from trust preflight through trends, recommendations, graph, alternatives, score, compare, and final citation.
Knowledge GraphOpen SourceRecommendationsAgent Tools
Properties
| Name | Type | Description |
|---|---|---|
| positioning | string | |
| summary | string | |
| input | object | |
| recommended_sequence | array | |
| shortlist | array | |
| trend_context | object | |
| agent_map | object | |
| trust_policy | object | |
| metadata | object |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/git-top/json-schema/git-top-workflow-response-schema.json",
"title": "WorkflowResponse",
"description": "Guided agent workflow from trust preflight through trends, recommendations, graph, alternatives, score, compare, and final citation.",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/git-top-workflow-api-openapi.yml#/components/schemas/WorkflowResponse",
"type": "object",
"required": [
"input",
"recommended_sequence",
"shortlist",
"trend_context",
"agent_map",
"trust_policy",
"metadata"
],
"properties": {
"positioning": {
"type": "string"
},
"summary": {
"type": "string"
},
"input": {
"type": "object",
"additionalProperties": true
},
"recommended_sequence": {
"type": "array",
"items": {
"$ref": "#/$defs/WorkflowStep"
}
},
"shortlist": {
"type": "array",
"items": {
"$ref": "#/$defs/Recommendation"
}
},
"trend_context": {
"type": "object",
"additionalProperties": true
},
"agent_map": {
"$ref": "#/$defs/AgentMapResponse"
},
"trust_policy": {
"type": "object",
"additionalProperties": true
},
"metadata": {
"$ref": "#/$defs/Metadata"
}
},
"additionalProperties": true,
"$defs": {
"AgentMapResponse": {
"type": "object",
"required": [
"surfaces",
"short_path",
"reference_path",
"trust_policy"
],
"properties": {
"name": {
"type": "string"
},
"positioning": {
"type": "string"
},
"purpose": {
"type": "string"
},
"production_base_url": {
"type": "string"
},
"rest_base_url": {
"type": "string"
},
"mcp_endpoint": {
"type": "string"
},
"openapi_url": {
"type": "string"
},
"schema_url": {
"type": "string"
},
"llms_url": {
"type": "string"
},
"llms_full_url": {
"type": "string"
},
"short_path": {
"type": "array",
"items": {
"$ref": "#/$defs/AgentPathStep"
}
},
"reference_path": {
"type": "array",
"items": {
"$ref": "#/$defs/AgentPathStep"
}
},
"core_surfaces": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"recommended_agent_flow": {
"type": "array",
"items": {
"type": "string"
}
},
"surfaces": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"trust_policy": {
"type": "object",
"additionalProperties": true
}
},
"additionalProperties": true
},
"AgentPathStep": {
"type": "object",
"properties": {
"step": {
"type": "integer"
},
"concept": {
"type": "string"
},
"rest": {
"type": "array",
"items": {
"type": "string"
}
},
"mcp_tools": {
"type": "array",
"items": {
"type": "string"
}
},
"inspect": {
"type": "array",
"items": {
"type": "string"
}
},
"trust_fields": {
"type": "array",
"items": {
"type": "string"
}
},
"use_when": {
"type": "string"
}
},
"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."
}
}
},
"NextAction": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"href": {
"type": "string"
},
"kind": {
"type": "string"
}
},
"additionalProperties": true
},
"NormalizedEvidence": {
"type": "object",
"description": "Normalized evidence package for agent citation and caveat handling.",
"properties": {
"classification": {
"type": "object",
"additionalProperties": true
},
"quality_signal_confidence": {
"$ref": "#/$defs/QualitySignalConfidence"
},
"verification": {
"oneOf": [
{
"$ref": "#/$defs/VerificationPackage"
},
{
"type": "null"
}
]
},
"source_fields": {
"type": "array",
"items": {
"type": "string"
}
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
},
"confidence_reason": {
"type": "string"
},
"last_verified_at": {
"type": [
"string",
"null"
],
"format": "date-time"
}
},
"additionalProperties": true
},
"ProjectCard": {
"type": "object",
"description": "Compact project card used in search, recommendations, comparison, alternatives, and related project lists.",
"required": [
"project_id",
"repo",
"name"
],
"properties": {
"project_id": {
"type": "string"
},
"repo": {
"type": "string"
},
"name": {
"type": "string"
},
"github_url": {
"type": "string"
},
"homepage_url": {
"type": [
"string",
"null"
]
},
"language": {
"type": [
"string",
"null"
]
},
"license": {
"type": [
"string",
"null"
]
},
"project_kind": {
"type": "string",
"enum": [
"project",
"collection"
]
},
"collection_metadata": {
"type": "object",
"additionalProperties": true
},
"category": {
"type": "array",
"items": {
"type": "string"
}
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"description": {
"type": "string"
},
"overview": {
"type": "string"
},
"deployments": {
"type": "array",
"items": {
"type": "string"
}
},
"difficulty": {
"type": "string"
},
"cloudflare_ready": {
"type": "boolean"
},
"git_top_score": {
"type": "number"
},
"quality_score": {
"type": "number"
},
"agent_score": {
"type": "number"
},
"score": {
"type": "number"
},
"classification": {
"type": "object",
"additionalProperties": true
},
"quality_signal_confidence": {
"$ref": "#/$defs/QualitySignalConfidence"
},
"verification": {
"$ref": "#/$defs/VerificationPackage"
},
"summary": {
"$ref": "#/$defs/ProjectSummary"
},
"evidence": {
"$ref": "#/$defs/NormalizedEvidence"
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
},
"confidence_reason": {
"type": "string"
},
"source_fields": {
"type": "array",
"items": {
"type": "string"
}
},
"last_verified_at": {
"type": [
"string",
"null"
],
"format": "date-time"
}
},
"additionalProperties": true
},
"ProjectSummary": {
"type": "object",
"required": [
"tl_dr",
"purpose",
"inputs",
"outputs",
"good_for",
"not_good_for",
"deployment",
"alternatives"
],
"properties": {
"tl_dr": {
"type": "string",
"description": "One-sentence project overview for agents."
},
"purpose": {
"type": "string",
"description": "Longer agent-facing project purpose."
},
"install": {
"type": [
"string",
"null"
],
"description": "Conservative install or setup hint when Git.Top can infer one."
},
"inputs": {
"type": "array",
"items": {
"type": "string"
}
},
"outputs": {
"type": "array",
"items": {
"type": "string"
}
},
"good_for": {
"type": "array",
"items": {
"type": "string"
}
},
"not_good_for": {
"type": "array",
"items": {
"type": "string"
}
},
"deployment": {
"type": "array",
"items": {
"type": "string"
}
},
"alternatives": {
"type": "array",
"items": {
"type": "object",
"required": [
"repo",
"reason"
],
"properties": {
"repo": {
"type": "string"
},
"reason": {
"type": "string"
}
}
}
}
}
},
"QualitySignalConfidence": {
"type": "object",
"description": "Completeness hints for GitHub-derived score inputs. Agents should avoid overclaiming partial or unknown signals.",
"properties": {
"stars_30d_delta": {
"type": "string",
"enum": [
"snapshot",
"estimated"
]
},
"stars_30d_window_days": {
"type": "integer"
},
"commits_30d": {
"type": "string",
"enum": [
"complete",
"partial",
"unknown"
]
},
"releases_180d": {
"type": "string",
"enum": [
"complete",
"partial",
"unknown"
]
},
"contributors_90d": {
"type": "string",
"enum": [
"complete",
"partial",
"unknown"
]
}
},
"additionalProperties": true
},
"Recommendation": {
"allOf": [
{
"$ref": "#/$defs/ProjectCard"
},
{
"type": "object",
"properties": {
"decision_summary": {
"type": "string"
},
"reasons": {
"type": "array",
"items": {
"type": "string"
}
},
"tradeoffs": {
"type": "array",
"items": {
"type": "string"
}
},
"fit_profile": {
"type": "object",
"additionalProperties": true
},
"adoption_plan": {
"type": "array",
"items": {
"type": "string"
}
},
"risk_flags": {
"type": "array",
"items": {
"type": "string"
}
},
"matched_constraints": {
"type": "object",
"additionalProperties": true
},
"unmatched_constraints": {
"type": "object",
"additionalProperties": true
},
"ranking_signals": {
"type": "object",
"additionalProperties": {
"type": "number"
}
},
"confidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"confidence_reason": {
"type": "string"
},
"evidence": {
"allOf": [
{
"$ref": "#/$defs/NormalizedEvidence"
},
{
"type": "object",
"properties": {
"recommendation_reasons": {
"type": "array",
"items": {
"type": "string"
}
},
"ranking_signals": {
"type": "object",
"additionalProperties": {
"type": "number"
}
},
"matched_constraints": {
"type": "object",
"additionalProperties": true
},
"unmatched_constraints": {
"type": "object",
"additionalProperties": true
}
},
"additionalProperties": true
}
]
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
},
"source_fields": {
"type": "array",
"items": {
"type": "string"
}
},
"last_verified_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"next_actions": {
"type": "array",
"items": {
"$ref": "#/$defs/NextAction"
}
}
},
"additionalProperties": true
}
]
},
"VerificationPackage": {
"type": "object",
"description": "Structured verification coverage for project selection. It does not claim install, security, runtime, or MCP execution unless a signal is verified.",
"required": [
"schema_version",
"overall_status",
"observed_at",
"signals",
"coverage",
"next_steps"
],
"properties": {
"schema_version": {
"type": "string",
"const": "git-top.verification.v1"
},
"overall_status": {
"type": "string",
"enum": [
"complete",
"partial",
"unverified"
]
},
"observed_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"signals": {
"type": "object",
"required": [
"activity",
"license",
"documentation",
"runtime",
"install",
"security",
"mcp"
],
"properties": {
"activity": {
"$ref": "#/$defs/VerificationSignal"
},
"license": {
"$ref": "#/$defs/VerificationSignal"
},
"documentation": {
"$ref": "#/$defs/VerificationSignal"
},
"runtime": {
"$ref": "#/$defs/VerificationSignal"
},
"install": {
"$ref": "#/$defs/VerificationSignal"
},
"security": {
"$ref": "#/$defs/VerificationSignal"
},
"mcp": {
"$ref": "#/$defs/VerificationSignal"
}
},
"additionalProperties": false
},
"coverage": {
"type": "object",
"required": [
"observed",
"inferred",
"not_run",
"unknown"
],
"properties": {
"observed": {
"type": "integer",
"minimum": 0
},
"inferred": {
"type": "integer",
"minimum": 0
},
"not_run": {
"type": "integer",
"minimum": 0
},
"unknown": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
},
"next_steps": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"VerificationSignal": {
"type": "object",
"description": "One project verification signal. observed and inferred are indexed evidence; not_run means the independent probe has not been executed.",
"required": [
"status",
"source",
"evidence"
],
"properties": {
"status": {
"type": "string",
"enum": [
"verified",
"observed",
"inferred",
"not_run",
"not_applicable",
"unknown"
]
},
"source": {
"type": "string",
"enum": [
"github_metadata",
"git_top_heuristic",
"git_top_runtime"
]
},
"evidence": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"WorkflowStep": {
"type": "object",
"properties": {
"step": {
"type": "integer"
},
"label": {
"type": "string"
},
"url": {
"type": "string"
},
"method": {
"type": "string"
},
"mcp_tool": {
"type": "string"
},
"inspect": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": true
}
}
}Work with this as data
Every JSON Schema 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 schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.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 JSON Schema
curl "https://apis.io/api/v1/json-schemas/git-top-workflow-response"
All schemas
curl "https://apis.io/api/v1/json-schemas?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.