Developer portal

Quickstart

This quickstart shows the simplest possible optimization request: define a scheduling problem, submit it to `/optimize`, and inspect the returned system state.

1. Submit a job

Start with a small scheduling payload. Include a problem type, a list of tasks, and the constraints that must remain true in the final plan.

POST /optimize request

{
  "type": "scheduling",
  "tasks": [
    {
      "id": "A",
      "duration": 3
    },
    {
      "id": "B",
      "duration": 2
    }
  ],
  "constraints": [
    "A must happen before B"
  ]
}

2. Inspect the response

Qtangl returns a structured solution plus execution metadata. For the MVP, this lets developers review how the schedule was ordered and which backend or method produced the result.

Response payload

{
  "solution": [
    {
      "task": "A",
      "start": "09:00"
    },
    {
      "task": "B",
      "start": "12:00"
    }
  ],
  "method": "hybrid-qaoa",
  "backend": "ibm_quantum_simulator"
}