Synthesize project

Run synthesis screening on the project configuration.

Work this page from top to bottom. Read Before you call this API, then Request syntax, then the walkthrough. Sample numbers show field names only.

How to use this documentation page

1. Skim the intro so you know what meter this call spends.
2. Complete the walkthrough once with the dummy key, then again with your live key.
3. Copy a language sample and keep JSON key names identical.
4. On every response, read HTTP status first.
5. When automation returns 202, open Jobs and usage and poll until the job finishes.

Before you call this API

• You have an active HENDOI account and a live HENSYNTH API key (hsk_…).
• You create the key from HENDOI Settings → Generate API key for HENSYNTH, or from the HENSYNTH Developers page.
• You will treat every numeric sample on this page as a shape guide, not measured engineering data.

Request syntax

1. Method. POST.
2. URL. https://hensynth.hendoi.com/api/v1/projects/a1b2c3d4-1111-2222-3333-444455556666/synthesize.
3. Header. Authorization: Bearer hsk_demo_4c91e2ab8d07. Or send the raw key in X-Hensynth-Key.
4. Body. JSON below.

Step by step

1. Sign in at https://hendoi.com/login, open Settings, then Generate API key for HENSYNTH. Copy the full hsk_… key once.
2. Send POST to https://hensynth.hendoi.com/api/v1/projects/a1b2c3d4-1111-2222-3333-444455556666/synthesize with the production host.
3. Prefer Authorization: Bearer hsk_…. Or use X-Hensynth-Key with no Bearer prefix.
4. Send the request with one of the language samples. Expect HTTP 200 when finished, or HTTP 202 with jobId when queued.
5. On 401, regenerate the key from Settings. On 403 with QUOTA_EXCEEDED, open Limits and errors.

Quick checklist

• □ Method and URL path are exact.
• □ Live HENSYNTH API key is in the Authorization (or X-Hensynth-Key) header.
• □ Client branches on HTTP status before reading result fields.

Example request

The key hsk_demo_4c91e2ab8d07 is a dummy. Replace it before you send.

POST https://hensynth.hendoi.com/api/v1/projects/a1b2c3d4-1111-2222-3333-444455556666/synthesize
Authorization: Bearer hsk_demo_4c91e2ab8d07
Content-Type: application/json

{
  "requirements": {
    "rangeKm": 80,
    "payloadKg": 3.0
  }
}

If the request is accepted

{
  "jobId": "job-demo-001",
  "status": "queued"
}

If the request is not accepted

HTTP 401, missing or deactivated key:

{
  "error": "This API key is deactivated or was not recognized. Only an active key can call the API."
}

HTTP 403, a meter is used up:

{
  "error": "API usage limit reached.",
  "meter": "apiRequests",
  "code": "QUOTA_EXCEEDED"
}

Language samples

Replace the dummy key before you send. Keep JSON key names identical.

cURL

curl -s -X POST \
  "https://hensynth.hendoi.com/api/v1/projects/a1b2c3d4-1111-2222-3333-444455556666/synthesize" \
  -H "Authorization: Bearer hsk_demo_4c91e2ab8d07" \
  -H "Content-Type: application/json" \
  -d '{"requirements":{"rangeKm":80,"payloadKg":3.0}}' \
  -w "\n%{http_code}\n"

Node.js

const res = await fetch("https://hensynth.hendoi.com/api/v1/projects/a1b2c3d4-1111-2222-3333-444455556666/synthesize", {
  method: "POST",
  headers: {
    Authorization: "Bearer hsk_demo_4c91e2ab8d07",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"requirements": {"rangeKm": 80, "payloadKg": 3.0}})
});
const data = await res.json();
console.log(res.status, data);

Python

import json, requests
payload = {
  "requirements": {
    "rangeKm": 80,
    "payloadKg": 3.0
  }
}
r = requests.post(
    "https://hensynth.hendoi.com/api/v1/projects/a1b2c3d4-1111-2222-3333-444455556666/synthesize",
    headers={"Authorization": "Bearer hsk_demo_4c91e2ab8d07", "Content-Type": "application/json"},
    data=json.dumps(payload),
)
print(r.status_code, r.json())