Postman

Import

1. File → Import → choose repo file openapi/advisor.openapi.yaml
   (also served at http://localhost:3040/openapi/advisor.openapi.yaml)
2. Or create requests by hand from Pipeline.

Environment

Variable	Example
baseUrl	http://localhost:3040
token	(from login)
sessionId	(from start session)

Collection order (mock)

1. GET {{baseUrl}}/api/steps
2. GET {{baseUrl}}/api/health
3. POST {{baseUrl}}/api/auth/login → save token
4. GET {{baseUrl}}/api/catalog/playbooks
5. POST {{baseUrl}}/api/classify — {"problem_statement":"sales are down"}
6. POST {{baseUrl}}/api/query/ask — {"question":"total sales yesterday"}
7. POST {{baseUrl}}/api/advisor/sessions — same problem → save session_id
8. If status is awaiting_manager:
   POST {{baseUrl}}/api/advisor/sessions/{{sessionId}}/answers
9. GET {{baseUrl}}/api/advisor/sessions/{{sessionId}}

Login Tests script

const json = pm.response.json();
if (json.data?.token) {
  pm.environment.set("token", json.data.token);
}

Start session Tests script

const json = pm.response.json();
if (json.data?.session_id) {
  pm.environment.set("sessionId", json.data.session_id);
}

Use Authorization → Bearer Token → {{token}} on protected routes.