V2 Repositories

Base URL: https://api.codefundi.app. Path repo_id accepts a UUID or a percent-encoded repository URL.

GET `/v2/repos`

Summary: Paginated list of indexed repositories for the caller. Credits: 1 credit / request.

Query parameters

Parameter	Type	Description
`scope`	enum	`private` (default) or `public`.
`search`	string	Optional name substring (max 200).
`limit`	int	Page size 1–100, default 20.
`offset`	int	Zero-based offset.
`order_by`	string	Sort field (default `created_at`).
`order`	enum	`asc` \| `desc` (default `desc`).

Response: repository list with pagination and plan-related meta such as max_repos_allowed when present.

cURL

repos.sh


curl -sS -G "https://api.codefundi.app/v2/repos" \
  -H "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "scope=private" \
  --data-urlencode "limit=20" \
  --data-urlencode "offset=0"

JavaScript


const  = 'https://api.codefundi.app'
 
const  = `${}/v2/repos?${new ({
  : 'private',
  : '20',
  : '0'
})}`
 
const 
const res: Responseres = await (, { : { 'X-API-Key': 'YOUR_API_KEY' } })

Python

repos.py


import urllib.parse
import urllib.request
 
q = urllib.parse.urlencode({"scope": "private", "limit": "20", "offset": "0"})
req = urllib.request.Request(
    f"https://api.codefundi.app/v2/repos?{q}",
    headers={"X-API-Key": "YOUR_API_KEY"},
)
with urllib.request.urlopen(req) as resp:
    print(resp.read().decode())

GET `/v2/public/repos`

Summary: Public repository catalog for discovery. No API key required for standard access. Anonymous callers may be rate-limited.

Query: limit (1–500), offset, since (ISO), file_count (optional top files).

POST `/v2/repos/index/new`

Summary: Queue indexing for a GitHub URL. Private repos use your linked GitHub account when present; public repos may index without a token.

Request body

Field	Required	Type	Description
`url`	yes	string	GitHub repository URL.
`branch`	no	string	Branch to index.
`update`	no	boolean	Default `false`. Set `true` to refresh an existing index.

Credits: 0 credits to queue indexing. Plan limits still apply to how many repositories you can keep indexed. See Credits and tiers.

Response: includes repository identity, file totals, and an initial file tree/index payload when available.

cURL

index-new.sh


curl -sS -X POST "https://api.codefundi.app/v2/repos/index/new" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d "{\"url\":\"https://github.com/org/repo\",\"branch\":\"main\",\"update\":false}"

JavaScript


interface IndexRepoRequest {
  url: string
  branch?: string
  update?: boolean
}

const body: IndexRepoRequest = {
  url: 'https://github.com/org/repo',
  branch: 'main',
  update: false
}

const res = await fetch('https://api.codefundi.app/v2/repos/index/new', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
  body: JSON.stringify(body)
})
//    ^?

Python

index_new.py


import json
import urllib.request
 
payload = {"url": "https://github.com/org/repo", "branch": "main", "update": False}
req = urllib.request.Request(
    "https://api.codefundi.app/v2/repos/index/new",
    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(resp.read().decode())

POST `/v2/repos/status`

Summary: Poll indexing state for a repository URL. Credits: 1 credit / request.

Request body

Field	Required	Type	Description
`url`	yes	string	Same URL passed to `/v2/repos/index/new`.

Response `data`

Field	Type	Description
`updating`	boolean	`true` while indexing is in progress.
`status`	boolean / flag	Active status for the source.
`name`	string	Optional display name.
`last_updated`	string	Optional timestamp.

cURL

repos-status.sh


curl -sS -X POST "https://api.codefundi.app/v2/repos/status" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d "{\"url\":\"https://github.com/org/repo\"}"

JavaScript


const res = await fetch('https://api.codefundi.app/v2/repos/status', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({ url: 'https://github.com/org/repo' })
})
//    ^?

Python

repos_status.py


import json
import urllib.request
 
payload = {"url": "https://github.com/org/repo"}
req = urllib.request.Request(
    "https://api.codefundi.app/v2/repos/status",
    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(resp.read().decode())

Deprecated: GET `/v2/repos/{repo_id}/readme`

Deprecated. Use GET /v2/repos/{repo_id}/blueprint instead.

Blast radius: POST …/radius, GET …/map
Blueprint and scope: GET …/blueprint, POST …/scope
Files: list and file Markdown documentation

V2 Repositories

GET /v2/repos

Query parameters

cURL

JavaScript

Python

GET /v2/public/repos

POST /v2/repos/index/new

Request body

cURL

JavaScript

Python

POST /v2/repos/status

Request body

Response data

cURL

JavaScript

Python

Deprecated: GET /v2/repos/{repo_id}/readme

Related intel routes

GET `/v2/repos`

GET `/v2/public/repos`

POST `/v2/repos/index/new`

POST `/v2/repos/status`

Response `data`

Deprecated: GET `/v2/repos/{repo_id}/readme`