API reference

Key points: Authenticate with X-API-Key. Production base URL is https://api.codefundi.app.

Code Fundi exposes a versioned HTTP API for the codebase map: search and research, repository indexing, blast radius, blueprint Markdown, file docs, history, and account utilities.

Example request

The snippets below call POST /v2/search (JSON search mode).

cURL

Terminal


curl -sS -X POST "https://api.codefundi.app/v2/search" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d "{\"query\":\"rate limit middleware\",\"chat\":false}"

TypeScript

client.ts


const  = await ('https://api.codefundi.app/v2/search', {
  : 'POST',
  : {
    'Content-Type': 'application/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
  : .({ : 'rate limit middleware', : false })
})
const 
const data: anydata = await .()

Python

client.py


import json
import urllib.request
 
payload = {"query": "rate limit middleware", "chat": False}
req = urllib.request.Request(
    "https://api.codefundi.app/v2/search",
    data=json.dumps(payload).encode(),
    headers={"Content-Type": "application/json", "X-API-Key": "YOUR_API_KEY"},
    method="POST",
)
with urllib.request.urlopen(req) as resp:
    print(json.loads(resp.read().decode()))

Base URLs

Environment	Base URL
Production	`https://api.codefundi.app`

Authentication

Protected routes accept:

Header (preferred): X-API-Key: <your_api_key>

Create and rotate keys in the dashboard or via API keys. Agent sign-up flows: Authentication.

Standard response shape

response-shape.json


{
  "status": "success | error",
  "message": "optional human-readable message",
  "data": {},
  "pagination": {},
  "meta": { "updated_at": "ISO-8601", "tier": "TIER_NAME", "credits_used": 0, "credits_remaining": 0 }
}

Streaming endpoints (application/x-ndjson) use their own framing; see V2 Search for research mode.

Plans, credits, and enforcement

Per-call credit costs and balance errors (402) are summarized in Credits and tiers. HTTP errors: API errors.

Versions at a glance

Version	Focus
V2	Search / research, repos, blast radius, blueprint, files, history, stats, keys