Apps API

Response Body (Array of AppSummary)

Errors: 500 — Registry read failure (corrupt manifest, missing apps directory)

Build the App Library page or a kit picker — sort by recency and group by kit:

// List apps and surface the most recent ones first
const apps: AppSummary[] = await fetch("http://localhost:3000/api/apps").then((r) => r.json());

const recent = [...apps].sort((a, b) => b.createdAt - a.createdAt).slice(0, 5);
recent.forEach((a) => {
console.log(`${a.name} — ${a.primitivesSummary}`);
});

import requests

# List apps and surface the most recent ones first
apps: list[dict] = requests.get("http://localhost:3000/api/apps").json()

recent = sorted(apps, key=lambda a: a["createdAt"], reverse=True)[:5]
for a in recent:
  print(f"{a['name']} — {a['primitivesSummary']}")

Example response:

[
  {
    "id": "tracker-revenue",
    "name": "Revenue Tracker",
    "description": "Daily revenue rollup with month-over-month comparison.",
    "rootDir": "/Users/team/.ainative/apps/tracker-revenue",
    "primitivesSummary": "1 profile · 2 blueprints · 1 table · daily 9am",
    "profileCount": 1,
    "blueprintCount": 2,
    "tableCount": 1,
    "scheduleCount": 1,
    "scheduleHuman": "daily 9am",
    "createdAt": 1746028800000,
    "files": ["manifest.yaml", "profiles/analyst.md", "blueprints/daily-rollup.yaml"]
  },
  {
    "id": "coach-onboarding",
    "name": "New-Hire Coach",
    "description": "Two-week onboarding workflow with weekly check-ins.",
    "rootDir": "/Users/team/.ainative/apps/coach-onboarding",
    "primitivesSummary": "1 profile · 1 blueprint · Monday 9am",
    "profileCount": 1,
    "blueprintCount": 1,
    "tableCount": 0,
    "scheduleCount": 1,
    "scheduleHuman": "Monday 9am",
    "createdAt": 1745510400000,
    "files": ["manifest.yaml", "profiles/coach.md", "blueprints/weekly-checkin.yaml"]
  }
]

Query Parameters

Response 200 — AppDetail (extends AppSummary with a manifest object)

manifest (subset of fields most clients use)

Errors: 404 — App not found

Render the app detail surface — pick a kit-specific component based on the manifest’s view.kit:

// Render the right kit component for the app
type Kit = "auto" | "tracker" | "coach" | "inbox" | "research" | "ledger" | "workflow-hub";

const detail = await fetch("http://localhost:3000/api/apps/tracker-revenue").then((r) => r.json());
const kit: Kit = detail.manifest.view?.kit ?? "auto";

// Discriminate on kit to pick the renderer (kit-specific binding shapes live in each resolver)
switch (kit) {
case "tracker":
  console.log(`Render TrackerKit for ${detail.manifest.name}`);
  break;
case "coach":
  console.log(`Render CoachKit for ${detail.manifest.name}`);
  break;
default:
  console.log(`Render generic AppView for ${detail.manifest.name}`);
}

import requests

# Render the right kit component for the app
detail: dict = requests.get("http://localhost:3000/api/apps/tracker-revenue").json()
kit: str = detail["manifest"].get("view", {}).get("kit", "auto")

# Discriminate on kit to pick the renderer
renderers = {
  "tracker": "TrackerKit",
  "coach": "CoachKit",
  "inbox": "InboxKit",
  "research": "ResearchKit",
  "ledger": "LedgerKit",
  "workflow-hub": "WorkflowHubKit",
}
print(f"Render {renderers.get(kit, 'generic AppView')} for {detail['manifest']['name']}")

Example response:

{
  "id": "tracker-revenue",
  "name": "Revenue Tracker",
  "description": "Daily revenue rollup with month-over-month comparison.",
  "rootDir": "/Users/team/.ainative/apps/tracker-revenue",
  "primitivesSummary": "1 profile · 2 blueprints · 1 table · daily 9am",
  "profileCount": 1,
  "blueprintCount": 2,
  "tableCount": 1,
  "scheduleCount": 1,
  "scheduleHuman": "daily 9am",
  "createdAt": 1746028800000,
  "files": ["manifest.yaml", "profiles/analyst.md", "blueprints/daily-rollup.yaml"],
  "manifest": {
    "id": "tracker-revenue",
    "name": "Revenue Tracker",
    "description": "Daily revenue rollup with month-over-month comparison.",
    "profiles": [{ "id": "analyst", "source": "profiles/analyst.md" }],
    "blueprints": [
      { "id": "daily-rollup", "source": "blueprints/daily-rollup.yaml", "trigger": { "kind": "row-insert", "table": "revenue-events" } },
      { "id": "month-compare", "source": "blueprints/month-compare.yaml" }
    ],
    "tables": [{ "id": "revenue-events" }],
    "schedules": [{ "id": "daily-9am" }],
    "permissions": { "preset": "git-safe" },
    "view": { "kit": "tracker" }
  }
}

Query Parameters

Response 200 — Cascade summary

Cascade summary

Errors: 400 — App id missing · 404 — Nothing to remove (app does not exist or already cleaned up) · 500 — Cascade failure (one or more removals threw)

Confirm the cascade in the UI before calling — once removed, an app’s manifest and uniquely-owned profiles cannot be restored without re-installing:

// Cascading delete — confirm what got removed for the toast
const result: { success: true; filesRemoved: number; projectRemoved: boolean; profilesRemoved: number; blueprintsRemoved: number } =
await fetch("http://localhost:3000/api/apps/tracker-revenue", { method: "DELETE" }).then((r) => r.json());

const parts: string[] = [];
if (result.filesRemoved) parts.push(`${result.filesRemoved} files`);
if (result.projectRemoved) parts.push("project");
if (result.profilesRemoved) parts.push(`${result.profilesRemoved} profiles`);
if (result.blueprintsRemoved) parts.push(`${result.blueprintsRemoved} blueprints`);

console.log(`Removed: ${parts.join(", ")}`);

import requests

# Cascading delete — confirm what got removed for the toast
response = requests.delete("http://localhost:3000/api/apps/tracker-revenue")
result: dict = response.json()

parts: list[str] = []
if result["filesRemoved"]:
  parts.append(f"{result['filesRemoved']} files")
if result["projectRemoved"]:
  parts.append("project")
if result["profilesRemoved"]:
  parts.append(f"{result['profilesRemoved']} profiles")
if result["blueprintsRemoved"]:
  parts.append(f"{result['blueprintsRemoved']} blueprints")

print(f"Removed: {', '.join(parts)}")

Example response:

{
  "success": true,
  "filesRemoved": 3,
  "projectRemoved": true,
  "profilesRemoved": 1,
  "blueprintsRemoved": 2
}