Your progress is only saved in this browser. to protect it and pick up on any device.

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.

0 of 2 steps0%
4

Extend the API With One Prompt

In the CLI module, adding an operation meant editing the spec, adding a request, writing a test and linting. Describe that outcome once and let the agent do all four. Because your repo's skills say what "done" looks like, you only need to state the goal.

  1. Send this prompt to your agent:

    Your coding agent — ~/postman-terminal-demo

    Add a `DELETE /tasks/{taskId}` operation to `openapi.yaml`. Give it an operationId, a description and a documented 404 response. Then add a matching "Delete task" request to the Tasks API collection with a `pm.test` that checks the status code, and run the spec lint and the collection lint.

    Paste this into your agent
  2. Review the diff before accepting it. The spec change, the new .request.yaml file and the test should all be small and readable:

    zsh — ~/postman-terminal-demo
    git diffgit diff
    0/1 run
  3. Commit and push, or ask the agent to:

    Your coding agent — ~/postman-terminal-demo

    Commit these changes with a clear message and push them.

    Paste this into your agent

Troubleshooting: If the agent adds the operation but no collection request, ask: "Also add the Delete task request to postman/collections/Tasks API." The request file must use the DELETE method and contain a pm.test( script.

5

Prompt a Failure Into the Mock

Happy-path mocks hide bugs. A client that has never seen a 404 won't handle one, so ask the agent to make the mock misbehave on purpose and prove your collection copes. The mock is code in your repo, so the change is a reviewable diff.

  1. Send this prompt:

    Your coding agent — ~/postman-terminal-demo

    Update the Tasks mock in `postman/mocks/` so `GET /tasks/{taskId}` returns a 404 with the JSON body `{"error": "task not found"}` when the id is `missing`. Keep the existing behaviour for every other id. Then start the mock and run the Tasks API collection against it with the Local environment, and tell me what passed and failed.

    Paste this into your agent
  2. Read the agent's report. Did it run the mock and the collection, and did it tell you what the 404 case did? If it only edited files, ask it to run them.

  3. Commit and push the mock change:

    Your coding agent — ~/postman-terminal-demo

    Commit the mock change and push it.

    Paste this into your agent

Troubleshooting: LiftOff looks for a 404 and the text task not found in your mock files, so keep that exact wording in the body.