API reference
`POST /optimize`
Submit a scheduling, routing, or allocation problem and receive a structured optimization result.
Request
{
"type": "schedule | routing | allocation",
"data": {},
"constraints": []
}Response
{
"status": "success",
"solution": {},
"cost": 12,
"method": "qaoa",
"backend": "ibm_qasm_simulator"
}Execution flow
- 1. Validate the problem type, payload shape, and constraints.
- 2. Convert the job into an optimization-ready representation.
- 3. Run the solver stack and return the best feasible result.
Error cases
- Invalid input
- Unsupported problem type
- Solver failure
- Timeout
MVP rate limit: 10 requests per minute per API key.