Developer portal
FAQ
Quick answers for integrators, operators, and evaluators.
Getting started
What is Qtangl?
Qtangl is a planning API for scheduling, routing, and staffing. You send constraints and resources; it returns a feasible plan, plain-English summary, and measurements your team can run.
How do I send my first request?
Follow the Quickstart: obtain a pilot API key, POST to /optimize with type schedule and a small task list, then read summary and metrics in the response.
Auth & keys
Which auth headers are supported?
Send Authorization: Bearer <key> or x-api-key: <key>. Missing or invalid keys return 401.
How do I get a production key?
Request access at /access. Pilot keys are suitable for sandbox and integration testing only.
Method honesty
When does method return "hybrid"?
Only when a bounded QAOA candidate beats or matches the classical baseline on objective. Otherwise you receive method: classical even if QAOA was attempted.
Can I use routing or allocation today?
Payload shapes are documented and accepted at the edge, but the live solver returns 501 for routing and allocation until those pipelines ship. See the Roadmap.
Limits & reliability
What is the default rate limit?
120 requests per minute per API key unless QTANGL_RATE_LIMIT_PER_MINUTE overrides it on the server.
What happens when no plan is feasible?
The API returns 422 with a detail message explaining which constraints could not be satisfied. Adjust inputs and retry.
Found an issue? Report documentation feedback