Skip to content

Developer portal

SDKs & integrations

Use any HTTP client against the JSON API today. Official typed SDKs are on the roadmap.

Official SDKs

@qtangl/sdk (TypeScript)

Coming soon

Typed models, retries, and method-honesty helpers.

qtangl (Python)

Coming soon

Pydantic request/response models and CLI utilities.

HTTP recipes (today)

curl

curl -X POST "https://sparkling-vibrancy-production-1a7a.up.railway.app/optimize" \
  -H "Authorization: Bearer 811f31d4-5b8e-4ed0-a7a2-8176e05eba63" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "schedule",
  "tasks": [
    {
      "id": "A",
      "duration": 3
    },
    {
      "id": "B",
      "duration": 2
    }
  ],
  "constraints": [
    "A must happen before B"
  ]
}'

OpenAPI

Integration tips

  • Read summary before solution — operators trust the narrative first.
  • Persist details.diagnostics for audit and method comparisons.
  • Handle 422 as a planning signal, not a transport failure.
  • Use idempotent retries only on 5xx and network errors, not on 422.