cuOpt Server (common)
Domain concepts for the cuOpt REST server. No deploy commands or client code here.
What the server does
- Accepts optimization requests (routing, LP, MILP) over HTTP.
- Returns a request ID; solution is obtained by polling with that ID.
- Does not support QP via REST.
Problem types supported
| Problem type | Supported |
|---|
| Routing | ✓ |
| LP | ✓ |
| MILP | ✓ |
| QP | ✗ |
Request flow (conceptual)
- Client sends problem data in the required schema (matrices, tasks, fleet, solver config).
- Server returns a
reqId.
- Client polls the solution endpoint with
reqId until the job completes.
- Response contains status and, on success, solution (routes, objective, primal values, etc.).
Required questions (deployment and usage)
Ask these if not already clear:
- Problem type — Routing or LP/MILP? (QP not available.)
- Deployment — Local, Docker, Kubernetes, or cloud?
- Client — Which language or tool will call the API (e.g. Python, curl, another service)?
Key endpoints (conceptual)
- Health check.
- Submit request (POST).
- Get solution by request ID (GET).
- OpenAPI spec (e.g. for payload format).