POST /api/zeq/opt

Numerical optimization — min f(x) by descent; convergence checked against the known optimum.

Method	POST
Path	/api/zeq/opt
Feature area	Zeq core & solvers
Tag	Solvers
Auth	machine key — Authorization: Bearer $ZEQ_KEY
Tier	authenticated (machine-control)

Solver

Summary	Numerical optimization — min f(x) by descent; convergence checked against the known optimum.
Domain	Optimization
Numerical Method	Numerical optimization (descent)
Operator Chain	KO42, CS75
Unit	f

See all sealed solvers.

Parameters

This operation publishes no path, query or header parameters.

Request body

Required. Content type: application/json.

Field	Type	Required	Description
operators	array<string>	no	Operator IDs to run. KO42 sets the metric frame, e.g. ["KO42","GR37","NM19"].
inputs	object<string, number>	no	Named numeric inputs the operators consume (mass, r, v, ...).
consts	object<string, number>	no	Optional constant overrides (t, alpha, f_H, ...).
domain	string	no	Optional domain hint (used by /compute and /auto).
query	string	no	Natural-language problem statement (used by /auto).

Responses

Status	Meaning
200	Sealed result envelope — value, unit, operatorChain, masterEquation, HMAC zeqProof.
401	Missing or invalid credentials
402	Insufficient compute credit

401 body

Field	Type	Required	Description
ok	boolean — one of false	yes	—
error	string	no	Human-readable message.
code	string	no	Stable machine-readable code, e.g. ADMIN_REQUIRED, INVALID_ZID, ZID_NOT_LINKED.

Call it

curl -sS -X POST https://zeq.me/api/zeq/opt \
  -H "Authorization: Bearer $ZEQ_KEY" \
  -H "Content-Type: application/json" \
  -d '{
         "operators": [
           "KO42"
         ],
         "inputs": {
           "mass": 70,
           "r": 1
         },
         "consts": {
           "t": 1
         },
         "domain": "Acoustics",
         "query": "speed of sound in air at 20 C"
       }'

Needs a machine key. Mint one: curl -sS -X POST https://zeq.me/api/demo-key/mint, then spin up your machine.

---

Generated from the live OpenAPI description (https://zeq.me/openapi.json, spec version 1.287.0) by scripts/generate-reference.mjs. Do not edit — this file is rewritten on every run.