---
title: "Improving the Machines API spec"
date: "2026-11-12"
author: "Philipp Winter"
url: "https://fly.io/changelog/improving-the-machines-api-spec/"
discussion: "https://community.fly.io/t/improving-the-machines-api-spec/29069"
---

# Improving the Machines API spec

Our Machines API docs are available at <https://docs.fly.io/api/machines>. 

Over time, some mistakes have snuck into the docs but many of you have helped us find and fix them. (Thanks to @praneetloke in particular for all the feedback!)

We are very grateful for that help but it's our job to catch these problems, so we spent some time  improving the docs. In particular, we...

1. added previously missing documentation, especially for response objects and their attributes
2. extended incomplete documentation (e.g., some endpoint descriptions were too sparse)
3. corrected inaccurate documentation

The added context should make for a more pleasant developer experience, for humans and agents alike. Hope it helps!
