Running the service means your requests return real responses as you build them. Deskly is a small Node.js/Express app, so you need Node.js 18 or newer installed. It keeps its data in memory and resets on restart.

1. Open the Postman terminal at the bottom of the desktop app to run the CLI commands. If it doesn't already open in your deskly-api folder, change into it:

   Copy

   cd deskly-api

2. Confirm Node.js is installed:

   Copy

   node --version

3. Install the dependencies and start the server:

   Copy

   npm install
   npm start

4. The console prints the base URL and the API key it's using:

   Copy

   ▸ Listening  http://localhost:4000
   ▸ API key    demo-key

5. Confirm it's up from Postman. Open a new HTTP request tab (click the + in the tab bar), then paste the health check curl command into the URL field — Postman parses the curl into a request automatically:

   Copy

   curl http://localhost:4000/health

   Hit Send. You should get a 200 with {"status":"ok","service":"deskly", ...}, confirming the server is up and running. The /health endpoint is public, so no API key is needed.

   Switch back to the terminal running the server and you'll see it log the request — the timestamp and response time will differ each time:

   Copy

   2026-08-13T17:26:28.465Z  INFO  GET    /health 200 3.9ms

You already sent Health Check by hand. Agent Mode can read the Deskly source in your connected folder and scaffold the rest — everything lands as YAML under postman/collections/ in Local View.

Create the collection

1. Confirm Local View (bottom left) and open Local Items in the left sidebar.
2. Click + → Collection and name it Deskly API.
3. With your Health Check request tab open, click Save → name it Health Check → save into Deskly API.

Saving in Local View writes files to disk — check Files and you'll see postman/collections/Deskly API/Health Check.request.yaml.

Let Agent Mode build the remaining requests

4. Open Agent Mode (right sidebar, or universal search → > agent mode).

5. Type @ and select Deskly API so the agent writes into your collection.

6. Paste a prompt like:

   Copy prompt

   Scan the Deskly API source code in this connected repo for every HTTP endpoint. For each one that isn't already in my "Deskly API" collection, add a request that targets http://localhost:4000, includes the X-API-Key: demo-key header, and has an example JSON body where the route expects one. Don't recreate the Health Check request I already saved.

7. Review what Agent Mode proposes and approve (unless Auto-run is on). Expand Deskly API and confirm new requests appeared.

8. Spot-check one request (e.g. Create Booking) — Send it against your running server.

What to expect

Agent Mode may name requests differently (e.g. Get All Desks instead of List Desks) and may add more than the table below. That's fine — use this as a checklist, not a strict count:

Troubleshooting

• 401 / 403 — add X-API-Key: demo-key to the request, or re-prompt Agent Mode to add it to every request except Health Check.
• Connection error — the Deskly server from the previous step isn't running on port 4000.
• Prefer manual? Paste a curl into a new request tab — e.g. curl http://localhost:4000/desks -H "X-API-Key: demo-key" — then save into the collection.