The Problem

API documentation is scattered across hundreds of sites, buried in PDFs, locked behind developer portals, and constantly going stale. AI agents are left to guess at parameters, hallucinate auth flows, and fail silently on edge cases. One Knowledge centralizes structured, human-verified knowledge for every tool across 500+ platforms, making it machine-ready and free forever.

What This Does

This repository provides the public API surface and contribution templates for the One Knowledge platform. The API contract is documented in README.md, which lists endpoints under https://api.withone.ai requiring the x-one-secret header. Process governance lives in .github/ISSUE_TEMPLATE/report-outdated-knowledge.yml and .github/ISSUE_TEMPLATE/request-new-platform.yml, which standardize how platform additions and updates are requested. No runtime source code is present in the clone; the repository functions as a manifest and governance layer rather than a service. README.md and the .github/ templates are the only artifacts with defined responsibility.

How It Is Wired

The internal call graph has not been mapped for this repository, as static analysis detected no runtime files (language breakdown consists of YAML and Markdown only; no .py, .js, or compiled artifacts were found). Entry points for knowledge retrieval are the documented API endpoints described in README.md, which route through the hosted service at https://api.withone.ai. The .github/ directory contains issue‑template workflows that govern how platform knowledge is added or updated, but there are no code‑level dependencies, hooks, or module graphs to trace. Any agent or tool integrating with this service depends on the external API contract and the x-one-secret authentication mechanism; the repository itself carries no execution logic. Where responsibility blocks or function maps are absent, the wiring has not been mapped for this repo yet.

How To Use It

Setup: The README references the One CLI for local integration. Install the CLI with npm install -g @withone/cli and run one init to configure your environment and API key. The clone https://github.com/moses-y/knowledge-Api does not contain a build or run command; it is a metadata repository.

Configuration: A free One API Key is required, obtained from the One Dashboard. The key must be passed as the x-one-secret header on all API requests.

Running it: To retrieve a platform’s knowledge, use the documented curl example from README.md:

curl 'https://api.withone.ai/open/knowledge/airtable' \
  --header 'x-one-secret: YOUR_ONE_API_KEY'

If initializing the CLI workflow from this repository’s context, run one init after installing the CLI, which is a separate package referenced by the README.

Real-World Use

An agent needing to list Airtable actions can call GET /open/knowledge/airtable/actions with the x-one-secret header, paginate via the page query param, and receive structured data on parameters, auth flows, and enforcement rules. The agent caches this verified knowledge locally and matches user requests against the schemas, avoiding hallucinations about auth scopes or parameter types. The API table in README.md provides the full response schema for each endpoint.

Code Health & Issues

Measured static analysis found:

  • No test files detected – untested code paths – repository-wide
  • No CI/CD pipeline detected – no automated build/test gate – .github/ or CI config
  • License present: LICENSE (OKCL-1.0)
  • No committed secrets found
  • No lockfile present
  • Dockerfile absent

The Bottom Line

This repo is a lightweight manifest and governance layer for the One Knowledge API surface; all runtime behavior is hosted externally. It’s useful as reference documentation and contribution scaffolding, but offers no runnable code, testing, or CI out of the box. Teams should treat it as documentation and process framework, not a deployable service. Ideal for engineers building MCP‑compatible agents who need a single, verified knowledge source and are comfortable integrating via the CLI or direct API calls.

Clone: https://github.com/moses-y/knowledge-Api (verbatim).