Sign in

Bruno Pedro

@brunopedro.com
7.1K followers 0 following 1.1K posts

Building an API Product: Design, implement, release, and maintain API products that meet user needs: a.co/d/dE6pQpK Opinions expressed are solely my own and do not express the views or opinions of my employer.

PostsRepliesMedia
Bruno Pedro @brunopedro.com · 7h
"Generating an MCP server from an OpenAPI document without writing everything twice is useful plumbing," said Erik Wilde (@dret.bsky.social) in this month's API Changelog News edition. See this and other great commentary by Erik: apichangelog.substack.com/p/2026-42
apichangelog.substack.com
AWS Agent Registry, Tyk AI Studio, Bump Flower, Redocly Code Mode for MCP
The API Changelog issue 2026.42
000
Bruno Pedro @brunopedro.com · 16h
"The promise of an AI assistant seems to fade with OpenAI’s approach to custom GPTs," I wrote in 2024. The missing link between AI and APIs is implicit discovery based on intent. We weren't there yet in 2024, and we're still not 100% there today. apichangelog.substack.com/p/the-missin...
apichangelog.substack.com
The Missing Link between AI and APIs
What is still missing from AI systems to efficiently connect to and use APIs?
020
Reposted by Bruno Pedro
Bruno Pedro @brunopedro.com · 01/10/2026
notes.brunopedro.com/2026/10/01/2... Being consistent means putting in the work every day and following your beliefs. It's about playing the long game instead of following the latest trends.
notes.brunopedro.com
- Bruno Pedro
Standardizing API strategy is about consistency, not trends
001
Reposted by Bruno Pedro
Phil Sturgeon 🌳🚵⚓️ @philsturgeon.com · 01/10/2026
If there’s one thing I care about that’s not climate related it’s making APIs you won’t hate, and the first step to guarding yourself from an increasingly sloppy world is getting a style guide automated. My babies Speccy & Spectral died. OpenLint is the answer. apisyouwonthate.com/blog/openlin...
apisyouwonthate.com
OpenLint: picking up where Spectral left off
In an age of relentless slop, it's never been more important to protect your API ecosystems with automated style guides, and whilst Spectral has slowed down, OpenLint is about to hit the ground runnin...
1134
Reposted by Bruno Pedro
Tate Collection @tate.bsky.social · 01/10/2026
Eduardo Paolozzi, Secrets of Internal Combustion Engine, 1967 botfrens.com/collections/14375/cont…
Presented by Rose and Chris Prater through the Institute of Contemporary Prints 1975
0144
Bruno Pedro @brunopedro.com · 01/10/2026
It's practically impossible to programmatically find and use the APIs you're interested in. Unless, of course, there was a machine-readable way of advertising their locations. apichangelog.substack.com/p/automating...
apichangelog.substack.com
Automating API Discovery with RFC 9727
Is this the best way to programmatically advertise your APIs?
020
Reposted by Bruno Pedro
Alex Russell @infrequently.org · 01/10/2026
In London? Like the web? Come along *this evening* from 7pm to Shoreditch where the lovely @londonwebstandards.org are hosting some of the prime movers shaking up mobile browser competition (also, me? weird). Tickets (free!) and details here: londonwebstandards.org/events/lws-o...
londonwebstandards.org
Meet Open Web Advocacy | London Web Standards
Meet the contributors from Open Web Advocacy, there will be a few talks by their members giving updates on the work they are doing to help make the web a better place for all.
11312
Bruno Pedro @brunopedro.com · 01/10/2026
notes.brunopedro.com/2026/10/01/2... Being consistent means putting in the work every day and following your beliefs. It's about playing the long game instead of following the latest trends.
notes.brunopedro.com
- Bruno Pedro
Standardizing API strategy is about consistency, not trends
001
Bruno Pedro @brunopedro.com · 30/09/2026
Four years ago I recorded a video showing the creation of an OpenAPI definition from scratch with the help of GitHub Copilot. It's amazing to see how much things have evolved since then. www.youtube.com/watch?v=8vdt...
youtube.com
OpenAPI definition with GitHub Copilot
YouTube video by Bruno Pedro
030
Bruno Pedro @brunopedro.com · 30/09/2026
Indeed, "you could, hypothetically, create an API that only you would use. I remember doing that a few times," I wrote in the first paragraph of the article.
000
Bruno Pedro @brunopedro.com · 30/09/2026
You don’t design APIs for yourself. "Consumer-focused API Design." That’s the name I like to give to the exercise of engaging with potential users to understand what they need. apichangelog.substack.com/p/consumer-f...
131
Bruno Pedro @brunopedro.com · 29/09/2026
A while ago, I was involved in decommissioning an API that had been running for a long time. It had its issues and was being replaced with a better, more performant, and updated API. How would I ensure that all the consumers stopped using the API? apichangelog.substack.com/p/deactivati...
apichangelog.substack.com
Deactivating an API, One Step at a Time
How do you make sure all consumers stop using an API so you can safely deactivate it?
030
Reposted by Bruno Pedro
Bruno Pedro @brunopedro.com · 28/09/2026
The "search engine" approach to finding APIs doesn't work. First, you need to know what to search for. Then, the APIs indexed by the search engine need to have their metadata well-written. apichangelog.substack.com/p/intent-bas...
apichangelog.substack.com
Intent-based API Discovery
How can AI agents implicitly discover what APIs to consume?
011
Bruno Pedro @brunopedro.com · 28/09/2026
Most API consumers now aren't human. We're long past those days. Now, AI agents can discover, make requests, and combine API operations, all on their own. apichangelog.substack.com/p/an-a2a-sur...
apichangelog.substack.com
An A2A Survival Guide for API Owners
How to build asynchronous, discoverable services for autonomous multi-agent networks.
010
Reposted by Bruno Pedro
Bulletin of the Atomic Scientists @thebulletin.org · 27/09/2026
Widely thought of as the "founder of the internet," Vint Cerf discusses the ideals behind the original internet—including the emphasis on the net being an open, neutral, level playing field—and how to re-install a sense of trust to today's new AI-dominated version.
buff.ly
“The internet is a giant copying machine”: Interview with Vint Cerf
Widely thought of as the “founder of the internet,” Vint Cerf talks about how to re-install a sense of trust to this new AI-dominated version, and the ideals behind the original internet—including…
22410
Bruno Pedro @brunopedro.com · 28/09/2026
The "search engine" approach to finding APIs doesn't work. First, you need to know what to search for. Then, the APIs indexed by the search engine need to have their metadata well-written. apichangelog.substack.com/p/intent-bas...
apichangelog.substack.com
Intent-based API Discovery
How can AI agents implicitly discover what APIs to consume?
011
Bruno Pedro @brunopedro.com · 27/09/2026
010
Bruno Pedro @brunopedro.com · 26/09/2026
Weekend...
110
Reposted by Bruno Pedro
Blaise Agüera y Arcas @blaiseaguera.bsky.social · 25/09/2026
This week marks one year since “What Is Intelligence?” was published.
1137
Reposted by Bruno Pedro
James Snell @jasnell.me · 25/09/2026
If you're not able to join us in person at @nodeconf.eu in Bologna, Italy next week, please do try to join us remotely here live.nodeconf.eu ... every talk will be broadcast live with downloadable recordings available after.
live.nodeconf.eu
NodeConf EU 2026 Live | Bologna, Italy
Watch NodeConf EU 2026 live from Bologna on 29-30 September.
0136
Reposted by Bruno Pedro
Shared Computer Network (SCN) @sharedcomputer.network · 26/09/2026
The cloud is always someone else's computer: lets start making it that we know those someone people better, and that we are in community together. Community Scale AI with @sharedcomputer.network
communityscaleai.leaflet.pub
What is the Shared Computer Network?
SCN: Community Scale AI
0102
Bruno Pedro @brunopedro.com · 25/09/2026
Should agents generate integration code once or let AI figure out how to consume APIs whenever they need to? apichangelog.substack.com/p/the-archit...
apichangelog.substack.com
The Architectural Limits of Agentic iPaaS
AI agents don't crash on API changes, they just get them wrong.
030
Bruno Pedro @brunopedro.com · 25/09/2026
Something I'm #writing related to agentic integration solutions.
The image shows the beginning of an article I'm writing: "Should agents generate integration code once or let AI figure out how to consume APIs whenever they need to? It's true that dynamic inference at runtime can cause hallucinated payloads, unpredictable latency, and potentially higher costs. On the other hand, letting AI write its own code creates a sprawl of custom integration scripts that may be impossible to maintain in the long term."
130
Bruno Pedro @brunopedro.com · 25/09/2026
Unknown side effects, runtime uncertainty, and loop saturation are just some of the challenges AI agents face today. How can you fix this? "What I propose is to augment the existing API naming conventions with an operation taxonomy focused on behavior." apichangelog.substack.com/p/the-taxono...
apichangelog.substack.com
The Taxonomy of API Operations
A behavioral classification system for machine-to-machine APIs.
012
Bruno Pedro @brunopedro.com · 24/09/2026
"(...) if you are an API product manager, I think you are now also becoming the MCP product manager because, as we said, MCP is another kind of API." Great conversation with Emmanuel Paraskakis at apidays Paris last year. apichangelog.substack.com/p/mcp-is-jus...
apichangelog.substack.com
MCP Is Just an API
Can API PMs manage MCPs? It’s the next logical step.
020
Bruno Pedro @brunopedro.com · 24/09/2026
I do agree that it's now cheaper than ever to build. Because of that, knowing what to build becomes more important. Perhaps the MVP isn't any longer the tool to understand if what you're building makes sense.
000
Reposted by Bruno Pedro
Local-First Conf @localfirstconf.com · 24/09/2026
Our friends at @inkandswitch.com wrote a lovely recap of this year’s event: www.inkandswitch.com/newsletter/d...
inkandswitch.com
Local-First Conf Recap
We had a lovely time at this year’s Local-First Conference in Berlin. In addition to two days of talks from leading figures in the local-first movement, we hosted a special “Lab Day” to share some of ...
161
Bruno Pedro @brunopedro.com · 24/09/2026
Anyone telling you that working with APIs is hard isn't telling the truth. What is hard isn't the API. It's all the tools, processes, and technical language surrounding it. apichangelog.substack.com/p/api-comple...
apichangelog.substack.com
API Complexity Is a Lie
How some businesses live off API complexity while others sell simplicity.
000
Reposted by Bruno Pedro
Blaise Agüera y Arcas @blaiseaguera.bsky.social · 23/09/2026
What do we actually mean when we talk about “AGI”? Enjoyed discussing this with @georgemusser.com for his latest piece in @sciam.bsky.social.
1137
Bruno Pedro @brunopedro.com · 23/09/2026
The MVP is dead When everyone can build quickly, what you choose to build and for whom becomes the whole game. notes.brunopedro.com/2026/09/23/2...
notes.brunopedro.com
- Bruno Pedro
The MVP is dead, says Steve Blank
210
Reposted by Bruno Pedro
Bruno Pedro @brunopedro.com · 23/09/2026
You can choose the design of the API operation that will trigger your workflow once it’s called. You can decide what are the input parameters that you’ll accept via the API operation. You can even try to adapt the shape of the request. apichangelog.substack.com/p/exposing-w...
A screenshot of the Arazzo Visual Editor experiment, including input variables. In this example, you can see two input variables and three operations taken directly from an OpenAPI definition. The user is chaining the input variables and the operations together to form a workflow. For more context, there's a demo video from November 2025 available (https://www.youtube.com/watch?v=MYaagA2yrdU).
121
Bruno Pedro @brunopedro.com · 23/09/2026
Arazzo Visual Editor demo: www.youtube.com/watch?v=MYaa...
youtube.com
Arazzo Visual Editor
YouTube video by Bruno Pedro
010
Bruno Pedro @brunopedro.com · 23/09/2026
You can choose the design of the API operation that will trigger your workflow once it’s called. You can decide what are the input parameters that you’ll accept via the API operation. You can even try to adapt the shape of the request. apichangelog.substack.com/p/exposing-w...
A screenshot of the Arazzo Visual Editor experiment, including input variables. In this example, you can see two input variables and three operations taken directly from an OpenAPI definition. The user is chaining the input variables and the operations together to form a workflow. For more context, there's a demo video from November 2025 available (https://www.youtube.com/watch?v=MYaagA2yrdU).
121
Bruno Pedro @brunopedro.com · 23/09/2026
Looks interesting. Is there a way to try it?
110
Reposted by Bruno Pedro
Mike Amundsen @mamund.bsky.social · 23/09/2026
what am I working on when i'm not writing new material for "AI-Driven API Design" w/ O'Reilly? I continue to run experiments to expand the functionality of my GRAIL autonomous ecosystem. here's a peek at a possible future for my current CLI environment. #api360 #apiDesign #genAI
141
Reposted by Bruno Pedro
Observable @observablehq.com · 22/09/2026
Pack four mirrored spheres inside the four walls of a tetrahedron (a pyramid). Paint the walls red, green, blue, and white. Then shoot rays out of your eyes. As they bounce, you find that the regions colored each color all somehow share a coastline. observablehq.com/@nxrix/wada-...
3156
Bruno Pedro @brunopedro.com · 22/09/2026
Why do we need a separate document to describe what an MCP server does, when the protocol already lets you inspect it live? apichangelog.substack.com/p/can-mcp-se...
apichangelog.substack.com
Can MCP Servers Finally Get Their Own OpenAPI?
You shouldn't have to run an MCP server to know what it does.
130
Bruno Pedro @brunopedro.com · 22/09/2026
Perhaps because you don't yet have enough money to say Fuck You?
000
Bruno Pedro @brunopedro.com · 22/09/2026
It's not the right moment to make changes. My available time is very limited, and I prioritize other things at the moment.
010
Bruno Pedro @brunopedro.com · 22/09/2026
If you don't know what the API Changelog newsletter is, here's a refresher: apichangelog.substack.com/about We are independent. We provide the “outside the bubble” perspective that leaders rely on to stay ahead. We’re not representing anyone’s voice except our own.
110
Bruno Pedro @brunopedro.com · 22/09/2026
When engineering, product, and business teams refer to capability, they should be talking about the same thing, shouldn't they? apichangelog.substack.com/p/capabiliti...
apichangelog.substack.com
Capabilities, Capabilities, Capabilities
When all you have is a hammer, everything looks like a nail.
010
Bruno Pedro @brunopedro.com · 21/09/2026
That makes sense.
000
Bruno Pedro @brunopedro.com · 21/09/2026
Random thought right now (perhaps because I'm wearing one): Why is it commonly accepted that bandages are mostly light skin color, but, at the same time, there are multiple tone emojis?
100
Bruno Pedro @brunopedro.com · 21/09/2026
Interesting, I wasn't aware of that. Thanks for sharing. Is there any documentation available?
100
Bruno Pedro @brunopedro.com · 21/09/2026
Are you talking about self-hosted runners self-updating themselves? If so, you can turn that off with the --disableupdate flag. See github.blog/changelog/20...
github.blog
GitHub Actions: Self-hosted runners can now disable automatic updates - GitHub Changelog
You now have more control over when your self-hosted runners perform software updates. If you specify the --disableupdate flag to the runner then it will not try to perform an…
100
Bruno Pedro @brunopedro.com · 21/09/2026
Calendar-based versioning allows GitHub to introduce breaking changes regularly without upsetting API consumers. Consumers won’t get mad because they can pin their requests to a particular API version, so they’re sure it won’t contain any breaking changes. brunopedro.com/2022/12/01/c...
brunopedro.com
Calendar-Based API Versioning - Bruno Pedro
Tim Rogers, a Product Manager at GitHub, recently announced that they are moving from incremental API versioning to something they’re calling “calendar-based.” The announcement explains what calendar-...
110
Reposted by Bruno Pedro
Camille Fournier @skamille.themanagerswrath.com · 20/09/2026
If you want a Sunday morning longread I wrote up a rough version of the talk I gave at LDX3 this week on the Manager's Path in the Age of AI skamille.medium.com/the-managers...
skamille.medium.com
The Manager’s Path in the Age of AI
This week, I gave a talk at LDX3 New York. When they asked me to speak and asked me for a topic, I said that it was probably time I finally…
49126
Bruno Pedro @brunopedro.com · 20/09/2026
It's an interesting approach. I like the "explore" stage where you can spend as long as you like discussing ideas and approaches.
000
Bruno Pedro @brunopedro.com · 20/09/2026
000
Bruno Pedro @brunopedro.com · 20/09/2026
I still have the same opinion I had about a year ago. I'm not saying that an HTTP 204 with an empty body is the only response to a DELETE operation. What I'm saying is that it's the best one. apichangelog.substack.com/p/http-204-i...
Post on LinkedIn with the content: "The best response for an HTTP DELETE operation is not an HTTP 200 status code with whatever response body you come up with. It's an HTTP 204 status code with an empty body."

This post received, until September 20, 2026, 195 likes, 86 comments, 6 reposts, and about 30k impressions.
040