{
  "schema_version": "newruntime-agent-readable-v0.1",
  "type": "post",
  "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.",
  "status": "published",
  "published_at": "2026-07-21",
  "topics": [
    "api-design",
    "agents",
    "tool-use"
  ],
  "source_urls": [
    "https://www.freestyle.sh/blog/opinion/designing-apis-for-agents"
  ],
  "routes": {
    "html": "https://newruntime.com/posts/agent-api-design/",
    "markdown": "https://newruntime.com/posts/agent-api-design.md",
    "json": "https://newruntime.com/posts/agent-api-design.json"
  },
  "source_format": "markdown"
}