---
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"]
---

# API Design - New Runtime

A New Runtime topic hub collecting signals, patterns, field notes, and public sources about api design.

## Short 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.

## Patterns

- [Agent-ready software exposes capabilities](https://newruntime.com/patterns/agent-ready-software-exposes-capabilities/): The agent-ready product boundary is a small set of observable, permissioned capabilities that external agents can compose safely.

## Field Notes

- [Agent APIs Need Fewer Magic Tricks and More Facts](https://newruntime.com/posts/agent-api-design/): 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.

## Recent Raw Signals

- 2026-07-16: [Agent-Readable REST Can Beat a Human-Focused SDK](https://newruntime.com/signals/agent-readable-rest-can-beat-a-human-focused-sdk/)
- 2026-07-01: [Agent-ready SaaS exposes primitives to external agents](https://newruntime.com/signals/agent-ready-saas-exposes-primitives/)

## Public 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