XcodeServer API Docs
Unofficial documentation of the Xcode Server API (Xcode 7 edition).
In late 2015, Apple published official Xcode Server API documentation. This project will thus not be maintained anymore, but feel free to use the existing examples while they're relevant.
For the best browsing experience, please visit the interactive documentation view at Apiary.
🎓 Getting Started With Xcode Server
To find out how to set up Xcode Server on your Mac in minutes (and more), check out my series of tutorials.
Many of us like the Xcode Server continuous integration tool. Recently it introduced an API which allows you to integrate it in your workflow. This API is however not yet fully documented, which this project attempts to fix.
This knowledge is used in XcodeServerSDK, an unofficial SDK for talking to the Xcode Server API written in Swift, where you can get a good understanding of how to call many of the following APIs. This enables tools like Buildasaur, which allow for Xcode Server to be an even more powerful tool.
Since there is no official documentation yet, calling APIs with bad parameters might brick your Xcode Server. Note that many of the API endpoints are used internally by Xcode Server, so it might not be smart to try everything. I will gradually document the tried and useful endpoints and warn against the more tricky ones. However, I am in no way liable for what you do with this information. I recommend to not experiment on your production Xcode Server and instead run a development Xcode Server on your development machine. There you can always reset everything with
sudo xcrun xcscontrol --reset, which deletes all Xcode Server data including your setup bots and integration assets.
If you want to know more about reverse engineering how Xcode Server works under the hood, check out my article.
🚀 API Documentation
Endpoints with ✅ are fully documented in our interactive documentation. Click on the section header (e.g.
Bots) to jump to the documentation. Below is a list of API endpoints we're aiming to document.
All the following API endpoints are JSON based.
For more restricted actions like creating a bot, you need to use Basic authentication. Such request has to contain a header like this
Authorization: Basic aGVsbG93b3JsZDpzZWNyZXRwYXNzd29yZA==
aGVsbG93b3JsZDpzZWNyZXRwYXNzd29yZA== is just
password, concatenated by
: and base64 encoded.
Yes! Great! Create a Pull Request 👍