Skip to content

Standard

OpenAPI

A machine-readable standard for describing REST APIs—endpoints, parameters, and schemas—used to generate documentation, client SDKs, and server code.

Known aliases

  • OAS
  • OpenAPI
  • OpenAPI spec
  • OpenAPI Specification
  • OpenAPI-style specification
  • Swagger

Current stories

buildOne report1 publisher

Django-Modern-Rest 0.16.0 puts Pydantic, msgspec and attrs schemas between agents and business logic

Django-Modern-Rest 0.16.0 ships with Pydantic, msgspec and attrs support, so a typed body can reject a malformed agent call before business logic. How strict that rejection is in production comes down to the model each endpoint declares.

Publishers:dev.to

Reality

Evidence35
Adoption
Not scored
Hype gap+30
Incentives
Not scored
Confidence35
buildConfirmed3 publishers

After Stainless's shutdown, Cloudflare open-sources the generator behind its cf CLI

Cloudflare open-sourced Forge, an Apache 2.0 pipeline that generates SDKs, CLIs and docs from an API definition. Teams that lost Stainless's hosted generator can run it themselves, though Cloudflare so far uses it only for its cf CLI.

Perspective Coverage

3 publishers
Builder
Builder 58%
Operator
Operator 34%
Investor
Investor 8%

Reality

Evidence60
Adoption15
Hype gap+20
Incentives55
Confidence65
buildOne report1 publisher

Missing description strings hid 21 working handlers from an in-app AI agent

One team's in-app AI agent never saw 21 working handlers because its tool manifest drops any entry without a description string. The text has to be written beside each handler's definition, so the team now runs gap tests that fail when a feature ships blank.

Publishers:dev.to

Reality

Evidence45
Adoption
Not scored
Hype gap+5
Incentives
Not scored
Confidence50
buildOne report1 publisher

Morgan Stanley pairs MCP with the architecture-as-code path that shipped 110 APIs

Jim Gough says the protocol part of MCP does little beyond client-server exchange, so the year of work at Morgan Stanley went into an architecture-as-code path that has put more than 110 APIs into production.

Publishers:infoq.com

Reality

Evidence38
Adoption45
Hype gap+5
Incentives60
Confidence45
buildOne report1 publisher

Only Stripe's dated version pin makes its OpenAPI diff safe to skip

A reproducible two-commit diff counted eight operations removed from GitHub's OpenAPI spec in six months, ten newly flagged across OpenAI's /videos surface in ten weeks, and nothing removed or flagged at Stripe.

Publishers:dev.to

Reality

Evidence62
Adoption35
Hype gap−8
Incentives68
Confidence55
scienceOne report1 publisher

UHP turns the choice of agent harness into a field in the request

The Unified Harness Protocol specifies how an application starts a task on an agent runtime, follows it, cancels it and collects the files, borrowing the shape of OpenAI's Responses API so existing streaming clients need no changes.

Publishers:unifiedharnessprotocol.org

Reality

Evidence32
Adoption
Not scored
Hype gap+35
Incentives62
Confidence52
buildOne report1 publisher

Rerunning the generator in --check mode makes a stale snapshot fail the build

Anton Brilliantov keeps one .proto per interface in a shared contract repository and generates the HTTP specification from it. The same discipline already governs his environment variable catalog and his metrics snapshot.

Publishers:dev.to

Reality

Evidence34
Adoption12
Hype gap+8
Incentives20
Confidence45
buildOne report1 publisher

An unquoted glob in a generated pack.sh makes LC_COLLATE part of the build

A dev.to walkthrough traces a checksum failure that only appears in CI to the shell expanding fragments/*.json in whatever collation order the job inherited, and proposes committing the file list so the order ships with the script.

Publishers:dev.to

Reality

Evidence52
Adoption
Not scored
Hype gap0
Incentives22
Confidence60
buildOne report1 publisher

Detecting OpenAPI spec drift with ast buys determinism at the cost of prefixed routers

A new zero-dependency CLI reads a Python codebase with the standard library and reports spec-only, code-only and method-mismatch paths, exiting 0 every time so the question of which drift fails a build stays with the team.

Publishers:dev.to

Reality

Evidence45
Adoption10
Hype gap−10
Incentives60
Confidence50
buildOne report1 publisher

Scoring the patch instead of the transcript still depends on four directory names

A reconstructed postmortem on dev.to has a merge bot posting eval=pass from a markdown summary, and its proposed replacement scores git diff only, with a contract test that keys on four directory names.

Publishers:dev.to

Reality

Evidence47
Adoption
Not scored
Hype gap+28
Incentives30
Confidence55
buildOne report1 publisher

Keeping one tool description in two files forked this MCP contract in two days

In a dev.to sample the same restaurant search tool is described once in a C# attribute and twice in Bicep, and two of the copies already disagree after two days of editing. The author's argument is that the description is the API contract now.

Publishers:dev.to

Reality

Evidence45
Adoption12
Hype gap+12
Incentives38
Confidence52
buildOne report1 publisher

Mapping a green Karate suite onto its OpenAPI contract leaves half the operations unproven

A dev.to walkthrough maps a fully green Karate suite back to its OpenAPI paths and finds half the customer operations with no scenario behind them, including both destructive methods on the resource.

Publishers:dev.to

Reality

Evidence45
Adoption
Not scored
Hype gap+10
Incentives30
Confidence55
buildOne report1 publisher

A phone agent answered two ICA keypad menus out loud until the line hung up at 193 seconds

CounterCall's builder pointed a voice agent at Singapore's immigration enquiries line and watched it talk to a touch-tone menu, because the platform's OpenAPI spec has no field for sending DTMF tones.

Publishers:dev.to

Reality

Evidence64
Adoption9
Hype gap0
Incentives35
Confidence62
buildOne report1 publisher

Four params_version values leave NovelAI's V5 output pixel-identical

A teardown of nai-diffusion-5-full on 2026-09-14 found params_version 4, 3, 1 and 0 all producing the same image, while a body missing v4_prompt came back as a 500 Internal Server Error that looks like a provider outage.

Publishers:dev.to

Reality

Evidence58
Adoption45
Hype gap−5
Incentives20
Confidence55
buildOne report1 publisher

Why an API's description field helps an AI agent decide which endpoint to call

More than half the traffic to one developer's API documentation now comes from AI agents. The changes that followed landed in the summary and description fields, where an agent does operation selection and error recovery.

Publishers:dev.to

Reality

Evidence34
Adoption15
Hype gap+10
Incentives45
Confidence45
leadershipOne report1 publisher

Evil Martians makes the API contract the artifact humans review in agent-written frontends

The consultancy's ten-check list treats generated code as something to prevent and detect rather than read line by line, which trades review labour for a dependency on whoever keeps the backend's OpenAPI spec current.

Publishers:evilmartians.com

Reality

Evidence46
Adoption20
Hype gap+14
Incentives58
Confidence54
buildOne report1 publisher

A cursor declaration in the route file gates the Pinia Colada adapter at compile time

Nuxt Endpoints builds on the validated-routing design under discussion in H3 RFC #1437, keeping files, URLs and methods while the declared schema constrains both the handler and the caller. The upstream design is still being debated.

Publishers:dev.to

Reality

Evidence58
Adoption18
Hype gap−12
Incentives72
Confidence55
productOne report1 publisher

ZeroDrift charges a penny a message to vet what an agent is about to tell a customer

Guard for Agents pulls policy documents out of Notion and Drive, turns them into a rule list you can toggle, and checks outgoing text before it ships. The extraction step, not the block, is what a buyer approves.

Publishers:siliconangle.com

Reality

Evidence32
Adoption8
Hype gap+28
Incentives76
Confidence54
buildOne report1 publisher

Proptech AI pilots stall at the read path out of the system of record

Brocoders' engineering postmortem reads this year's proptech survey numbers as a systems diagram. What it finds in the gap between 92% piloting and 5% succeeding is four integration jobs the pilot budgets never priced.

Publishers:dev.to

Reality

Evidence28
Adoption22
Hype gap+22
Incentives80
Confidence35
buildOne report1 publisher

Nine of twenty-one upstream API change types break an MCP tool outright

A dev.to walkthrough treats each MCP tool as a contract with the AI client rather than a wrapper, and counting the entries in its own change taxonomy shows how little upstream drift you get to absorb quietly.

Publishers:dev.to

Reality

Evidence38
Adoption
Not scored
Hype gap−12
Incentives18
Confidence47

Earlier coverage