Module 2 of 4 in Native Git in Postman
Continue with your Deskly API from Native Git in Postman. You generate an OpenAPI spec from your collection in Local View, keep the two linked, and push the spec to GitHub.
- You'll build
- An OpenAPI spec for Deskly, linked to your collection and pushed to your fork.
- Time
- About 20 min · 3 parts · 6 steps · progress saves as you go
- How it works
- You do each step, then click Validate and LiftOff checks your work. 3 of the 6 steps can't be checked automatically, so you click Done for those.
- You'll need
- A free Postman account and API key (connect it below)
- A few setup steps, shown below before you start
Connect a Postman API key to check your work
You do each step in Postman, then LiftOff uses your key to look at your workspace and confirm it's done. Connect once and it works for every module. Your key is saved in this browser and is only used to check your work in Postman.
Before you start
Complete Native Git in Postman first. This module reuses the same public deskly-api fork, [Your name] - Native Git workspace, connected local folder, and Deskly API collection on feature/deskly-collection.
When you reopen Postman, Local View may show main in the bottom left — checkout feature/deskly-collection before the collection appears in the sidebar (Part 2 Step 1 walks you through this).
You'll also need:
- Postman desktop app — Native Git and Local View are desktop-only.
- Git and your existing
deskly-apiclone connected to the workspace. - A public GitHub fork with your collection already pushed on a
feature/branch.
Confirm Your Deskly Setup
This module picks up where Native Git left off. LiftOff checks your fork on GitHub — you don't need to recreate the workspace or reconnect the folder unless you've started fresh on a new machine.
Generate an OpenAPI Spec in Local View
Spec Hub can derive an OpenAPI document from the collection you already built. First switch to the Git branch where your collection lives — then generate the spec in Local View so Postman writes files under postman/specs/.
Push the Spec to GitHub
Push the spec to a feature branch on your fork — that's all LiftOff needs. No pull request or merge required.