fkilcommins

Why API-First Matters in an AI-Driven World As AI applications expand, an API-first approach ensures robust, scalable, and consumer-friendly systems.

AI is evolving fast and structured, deterministic interfaces still matter.

For agents to reason and act reliably, they need more than endpoints. They need well-designed API capabilities.

I covered more on the topic below👇
smartbear.com/blog/why-api...

#OpenAPI #AgenticWorkflows #MCP #Arazzo

16 Billion Apple, Facebook, Google And Other Passwords Leaked — Act Now Change all your account passwords now — don’t wait: 16 billion credentials are confirmed as having been leaked.

Friday ToDo: Cycle all passwords 🔒

𝟭𝟲 𝗯𝗶𝗹𝗹𝗶𝗼𝗻 credentials (for social media, email, VPNs, dev portals) have been leaked according to security researchers.

For "dev portals" you should also cycle issued keys/credentials for clients (with advance comms of course).

www.forbes.com/sites/daveyw...

2023 OWASP Top 10 API Security Risks - YouTube The Open Worldwide Application Security Project (OWASP) recently launched a refreshed top 10 list of API security risks. This playlist dives into each of the...

APIs are being generated at lightning speed (GenAI 🚀), and AI is now a major API consumer (including the malicious kind)

Have you already adopted a secure-by-design approach?

🔒 Tip: Know the OWASP API Top 10

📺 Video breakdown: www.youtube.com/playlist?lis...

#apisecurity #owasp #securebydesign

YouTube video by apidays Apidays Helsinki & north 2025 - AI will Decide your API’s Fate! By Frank Kilcommins.

Curious what AI means for API delivery?
Check out my #APIDays talk:
🎥 www.youtube.com/watch?v=DlNw...

Our latest AI-powered features:

OpenAPI / AsyncAPI gen
Spectral rules gen
API Functional + contract tests
Dev portal docs

Are we done hand-writing OpenAPI from scratch?
#APIs #AI #SmartBear

I’ll be speaking at #apidaysHelsinki on June 4th!

Talks/Panels
➊ 𝗔𝗜 𝗠𝗮𝘆 𝗗𝗲𝗰𝗶𝗱𝗲 𝘆𝗼𝘂𝗿 𝗔𝗣𝗜’𝘀 𝗙𝗮𝘁𝗲
➋ 𝗚𝗲𝘁𝘁𝗶𝗻𝗴 𝘁𝗵𝗲 𝗥𝗶𝗴𝗵𝘁 𝗔𝗣𝗜 𝗙𝗮𝘀𝘁𝗲𝗿 using Example Mapping, OpenAPI, & #Arazzo
➌ Building Communities with @openapis.org

Free guest tickets: ticket.apidays.global/event/apiday...

Hope to see you there! 🚀

YouTube video by Erik Wilde How does AI affect APIs? Expert Opinions from API Days New York 2025

🎥 How does #AI affect #APIs? @dret.bsky.social compiled Expert Opinions from API Days New York 2025.

Insights on AI as a consumer, doc requirements, discoverability, security needs, increasing API numbers etc.

Well worth a watch!!

www.youtube.com/watch?v=6ekE...

I’m at 53 for the same conf (albeit explicit builds for export purposes) and I’m also thinking about switching to 1 slide, some sketches and an interactive demo!!

Introducing Spectral’s New ‘OR’ Function Spectral adds a new or function to simplify rule creation by allowing one or more properties to satisfy a condition. Learn how to use it with examples.

New 𝚘𝚛 𝗰𝗼𝗿𝗲 𝗳𝘂𝗻𝗰𝘁𝗶𝗼𝗻 just landed in #Spectral! Define rules that pass if 𝙖𝙣𝙮 of several props exist (e.g., 𝚝𝚒𝚝𝚕𝚎, 𝚜𝚞𝚖𝚖𝚊𝚛𝚢, or 𝚍𝚎𝚜𝚌𝚛𝚒𝚙𝚝𝚒𝚘𝚗)💡

More flexible for real-world @openapis.org docs.

Check the blog for use cases + examples:
blog.stoplight.io/introducting...
#apidesign #openapi #devtools

Always a great read @brunopedro.com

SmartBear Automates API Testing, Fern $9M, Okta Non-human Identities The API Changelog issue 2025.15

"SmartBear's API Hub for Test automates testing by simplifying API validation throughout the development process and integrating with CI/CD pipelines. The solution aims to decrease the maintenance workload for software development teams."

apichangelog.substack.com/p/2025-15

The 𝗢𝗽𝗲𝗻 𝗔𝗴𝗲𝗻𝘁𝗶𝗰 𝗞𝗻𝗼𝘄𝗹𝗲𝗱𝗴𝗲 (𝗢𝗔𝗞) manifesto published by @jentic.bsky.social has 10 principles for how #ai-agents and #APIs should act together.

Focus is on:
- Better API Docs
- Leveraging #OpenAPI + #Arazzo to compliment #MCP
- Vendor agnostic interop

The manifesto: github.com/jentic/oak/b...

#APIs are being built faster than ever, but is quality keeping pace? API downtime can cost $100K+ per hour, quality can’t be an assumed.

I’m excited about API Hub for Test, our newest addition to SmartBear’s API Hub with testing directly in your workflow!

smartbear.com/blog/from-de...

#apitesting

Nice to see updates within the @openapi.bsky.social initiative getting a shout out in the LF newsletter!

YouTube video by SmartBear AI-Powered API Design with SmartBear API Hub — HaloAI in Action

🚀 AI-powered API design & governance features now inside SmartBear API Hub.

Use natural language to go from 𝘼𝙋𝙄 𝙘𝙤𝙣𝙘𝙚𝙥𝙩 𝙩𝙤 𝙊𝙥𝙚𝙣𝘼𝙋𝙄 𝙙𝙤𝙘𝙪𝙢𝙚𝙣𝙩 leveraging templates and governance standards automatically from your API Hub organisation.

www.youtube.com/watch?v=5hyC...
#OpenAPI #APIGovernance #AI

GitHub - frankkilcommins/spectral-custom-functions: A collection of custom Spectral functions I find myself needing from time to time A collection of custom Spectral functions I find myself needing from time to time - frankkilcommins/spectral-custom-functions

Using #spectral for #API linting? Wanted to use the 𝙘𝙖𝙨𝙞𝙣𝙜 𝙛𝙪𝙣𝙘𝙩𝙞𝙤𝙣 in with Hypertext Application Language or Compact URIs?

Some custom functions to help:
◦ 𝚑𝚊𝚕-𝚌𝚊𝚜𝚒𝚗𝚐 - casing rules with HAL
◦ 𝚌𝚞𝚛𝚒𝚎-𝚌𝚊𝚜𝚒𝚗𝚐 - casing rules with CURIEs

repo:
github.com/frankkilcomm...

#apidesign #apigovernance

A gem from our OpenAPI archives! In this video Frank Kilcommins of SmartBear introduces the concept of Arazzo and how it actually works in practice.

Watch the full video here: zuplo.link/arazzo

Sometimes it's the small things!

I've updated all our #Swagger docs examples, links, and references to reflect #OpenAPI 3.0.4 and 3.1.1 respectively.

Still loving our new docs site too:
swagger.io/docs/specifi...

SmartBear unveils AI-driven API and Insight Hubs for teams

buff.ly/40qm2Aj

"The Insight Hub focuses on providing development teams with enhanced observability features."

#api360 #observability

The Rise of AI Agents: How Arazzo Is Defining the Future of API Workflows AI agents are revolutionizing software interactions — structured API workflows ensure they operate efficiently.

Are your #APIs and API-based capabilities ready for #AIAgents? Can #Arazzo bring control, discoverability, and improve the outcomes for the new wave of API consumers?

I penned my opinions for the @thenewstack.io

thenewstack.io/the-rise-of-...

Enjoyed speaking at @iata.org Open API Working Group @ WDS ✈️ Great discussions on #OpenAPI, #Arazzo & #AsyncAPI! 🚀 Nice to see the role #Stoplight & #Spectral play in airline API standardization. Excited to keep supporting from SmartBear & drive API interoperability forward! #APIs #IATA

Always a pleasure chatting with the incredibly knowledgeable @kinlane.bsky.social (aka @apievangelist.com). This time we focused on #Arazzo and the maturing of the #OpenAPI Initiative into a multi-specification project under the @linuxfoundation.org

#apis #apiworkflows

GitHub - frankkilcommins/arazzo-snippets-and-images: Little code snippets and images used for Arazzo content Little code snippets and images used for Arazzo content - frankkilcommins/arazzo-snippets-and-images

Most of the snippets within the blog are images created using the wonderful `https://ray.so`. If you’d like to get your hands on the raw YAML, then fear not – all exist within the following GitHub repo:
github.com/frankkilcomm...

The Arazzo Specification – A Deep Dive

Curious about the #Arazzo Specification from the #OpenAPI Initiative?

My deep dive breaks it down—in plain English!

🔹 What is Arazzo?
🔹 Where it adds value
🔹 The structure (simplified)
🔹 Real-world example
🔹 Fast-tracking with ArazzoGPT

👉 swagger.io/blog/the-ara...

#apis #apiworkflows #aiagents

#DeveloperWeek starts today. I’ll be kicking off with a workshop titled 𝙄𝙣𝙩𝙧𝙤 𝙩𝙤 𝘾𝙤𝙣𝙩𝙧𝙖𝙘𝙩 𝙏𝙚𝙨𝙩𝙞𝙣𝙜: 𝙀𝙫𝙤𝙡𝙫𝙞𝙣𝙜 𝘼𝙋𝙄 𝙎𝙖𝙛𝙚𝙡𝙮 showcasing the value and insights provided by contract testing letting teams deploy #API changes with confidence.

Full details: developerweek2025.sched.com/event/1tn54?...

🔥 Latest edition of 𝗡𝗼 𝗙𝗹𝘂𝗳𝗳, 𝗝𝘂𝘀𝘁 𝗥𝗲𝗮𝗹 𝗦𝘁𝘂𝗳𝗳 newsletter is out💥

Sit back, relax, and catch up on some of the latest developments from SmartBear, open-source happenings in the #API space, our library reads including tips and tricks, upcoming conferences & more!

www2.smartbear.com/index.php/em...

Announcing Arazzo Specification version 1.0.1 - OpenAPI Initiative The Arazzo Specification version 1.0.1 is now available, providing corrections, clarifications, and examples for Arazzo implementers.

#OpenAPI has launched v1.0.1 of the #Arazzo Specification!

Arazzo is a description language that can reference multiple #APIs, each described with an OpenAPI description or another Arazzo doc, providing consumers with a rich view of complex, multistep workflows

www.openapis.org/blog/2025/01...

We’ve released 0.8.0 of 𝗘𝘅𝗽𝗹𝗼𝗿𝗲.𝗖𝗹𝗶 - supporting nested Postman Collections (our most frequently requested feature) in our import to #SwaggerHub Explore 🚀

We've also added an`𝚒𝚖𝚙𝚘𝚛𝚝-𝚙𝚊𝚌𝚝-𝚏𝚒𝚕𝚎` feature allowing you explore the #API calls representing consumer expectations within a #Pact contract.

1.0.1 patch version by frankkilcommins · Pull Request #318 · OAI/Arazzo-Specification Arazzo – 1.0.1 release PR (to main) Fixes #282 Fixes #281 Fixes #268 Fixes #247 Fixes #244 Fixes #245 Fixes #233 Fixes #241 Fixes #242 Fixes #231 Fixes #220

The release of 1.0.1 of the #Arazzo Specification from #OpenAPI is ready to go.
github.com/OAI/Arazzo-S...

It improves clarity, resolves bugs, and we’ve bundled a formal #JSONSchema for Arazzo too. We’ll follow up in the coming days with the formal publishing and release blog with full details.

Release v1.0.0-beta.6 · swagger-api/apidom 1.0.0-beta.6 (2024-12-30) Features ls: add support for OpenAPI 3.0.4 (#4628) (d973f6d), closes #4612 ns-openapi-3-0: add support for OpenAPI 3.0.4 (#4613) (e1c2eb7), closes #4612 parser-adapter-op...

#OpenAPI 3.0.4 support is now available in #Swagger JavaScript tooling!

This support is available starting with the tooling versions listed below:

ApiDOM: github.com/swagger-api/...
SwaggerJS: github.com/swagger-api/...

3.1.1 coming soon!