{
  "schema_version": "newruntime-topic-hub-v0.1",
  "type": "topic_hub",
  "slug": "api-design",
  "title": "API Design - New Runtime",
  "description": "A New Runtime topic hub collecting signals, patterns, field notes, and public sources about api design.",
  "answer": [
    "API Design is tracked here as an evidence-linked topic, not as a static glossary entry.",
    "The page connects raw observations to pattern hypotheses, longer analysis, and public sources.",
    "Use it as the canonical landing page before drilling into individual records."
  ],
  "search_intents": [
    "api design",
    "api design AI agents",
    "api design software"
  ],
  "status": "tracked",
  "last_updated": "2026-07-21",
  "counts": {
    "total": 5,
    "signals": 2,
    "patterns": 1,
    "posts": 1,
    "atlas": 1,
    "sources": 6
  },
  "routes": {
    "html": "https://newruntime.com/topics/api-design/",
    "markdown": "https://newruntime.com/topics/api-design.md",
    "json": "https://newruntime.com/topics/api-design.json"
  },
  "top_sources": [
    "https://blog.cloudflare.com/code-mode-mcp",
    "https://blog.cloudflare.com/temporary-accounts",
    "https://github.com/tencentcloud/CubeSandbox",
    "https://trycase.dev/docs",
    "https://www.freestyle.sh/blog/opinion/designing-apis-for-agents",
    "https://x.com/EnoReyes/highlights"
  ],
  "patterns": [
    {
      "kind": "Pattern",
      "slug": "agent-ready-software-exposes-capabilities",
      "title": "Agent-ready software exposes capabilities",
      "description": "The agent-ready product boundary is a small set of observable, permissioned capabilities that external agents can compose safely.",
      "date": "2026-07-16",
      "topics": [
        "agent-ready",
        "api-design",
        "agent-infrastructure"
      ],
      "source_count": 5,
      "metric": "high",
      "url": "https://newruntime.com/patterns/agent-ready-software-exposes-capabilities/"
    }
  ],
  "field_notes": [
    {
      "kind": "Field Note",
      "slug": "agent-api-design",
      "title": "Agent APIs Need Fewer Magic Tricks and More Facts",
      "description": "Agent-first APIs should return explicit fields, precise errors, raw facts, and traceable metadata so models can repair tool calls deterministically instead of guessing world state.",
      "date": "2026-07-21",
      "topics": [
        "api-design",
        "agents",
        "tool-use"
      ],
      "source_count": 1,
      "url": "https://newruntime.com/posts/agent-api-design/"
    }
  ],
  "raw_signals": [
    {
      "kind": "Raw Signal",
      "slug": "agent-readable-rest-can-beat-a-human-focused-sdk",
      "title": "Agent-Readable REST Can Beat a Human-Focused SDK",
      "description": "Stable HTTP resources and explicit schemas may be easier for agents to inspect and compose than opaque client libraries with hidden behavior.",
      "date": "2026-07-16",
      "topics": [
        "agent-ready",
        "api-design",
        "rest"
      ],
      "source_count": 1,
      "metric": "notable",
      "url": "https://newruntime.com/signals/agent-readable-rest-can-beat-a-human-focused-sdk/"
    },
    {
      "kind": "Raw Signal",
      "slug": "agent-ready-saas-exposes-primitives",
      "title": "Agent-ready SaaS exposes primitives to external agents",
      "description": "Cloudflare's Code Mode compresses broad API access into search and execute primitives instead of thousands of tool definitions.",
      "date": "2026-07-01",
      "topics": [
        "agent-ready-web",
        "mcp",
        "saas",
        "api-design"
      ],
      "source_count": 1,
      "metric": "structural",
      "url": "https://newruntime.com/signals/agent-ready-saas-exposes-primitives/"
    }
  ],
  "atlas_records": [
    {
      "kind": "Delta",
      "slug": "agent-first-api-contracts",
      "title": "Agent-first API makes retries deterministic",
      "description": "Explicit fields, precise errors, request metadata, and raw facts turn an agent retry from guessing into near-deterministic repair.",
      "date": "2026-07-21",
      "topics": [
        "api-design",
        "agents",
        "tool-use"
      ],
      "source_count": 1,
      "metric": "B2",
      "url": "https://newruntime.com/deltas/agent-first-api-contracts/"
    }
  ]
}