Postman Collection

A pre-configured Postman collection is included for quick testing of all endpoints.

Import

1. Open Postman
2. Click Import
3. Drag in both files from the docs/postman/ directory:
   • ek-hub-headless-chat-api.postman_collection.json
   • ek-hub-headless-chat-api.postman_environment.json

Configure

After importing, set the environment variables:

Run

The collection includes requests in the recommended order:

1. List Agents — GET /agents
2. Get Agent Details — GET /agents/{agentId}
3. Create Session — POST /agents/{agentId}/sessions
4. List Sessions — GET /agents/{agentId}/sessions
5. Send Message — POST /agents/{agentId}/sessions/{sessionId}/messages
6. Get Messages — GET /agents/{agentId}/sessions/{sessionId}/messages
7. Get Session Details — GET /agents/{agentId}/sessions/{sessionId}
8. Update Session — PATCH /agents/{agentId}/sessions/{sessionId}
9. Delete Session — DELETE /agents/{agentId}/sessions/{sessionId}

Tips

• Run requests in order — later requests depend on IDs from earlier ones
• Check the environment variables tab to see saved IDs
• Use the Tests tab to see auto-set variable scripts