Inovacc Developer

API reference / Decision engine

Run a model

POSThttps://ai.inovacc.dev/v1/run

Answer structured questions about a state, with a verdict and a confidence for each.

Body params

  • modelstring

    A decision route id from GET /v1/models. No value uses your organization's default route.

  • inputobjectrequired

    {"state", "questions", "images"?}. Any other field is refused with invalid_decision_input.

  • input.stateanyrequired

    What to judge: any JSON value but null.

  • input.questionsobjectrequired

    1 to 64 questions keyed by your ids. Each has a type (noul, choice or score), instructions and criteria in the strict shape of its type.

  • input.imagesarray

    At most 16 images to judge with the state.

  • escalateboolean | object

    Ask doubtful questions again on the next stronger tier. true uses the defaults; an object takes min_confidence and max_tier.

Headers

  • Authorizationstringrequired

    Bearer <API key>

  • X-Operation-Idstringrequired

    a unique id you choose, on every call except GET

  • Content-Typestringrequired

    application/json, on a call with a body

See also

Source details

Catalogue entry

Id
identity/component-taxonomy/capabilities#decision
Repository
identity
Path
contracts/component-taxonomy/catalog/capabilities.json
Commit
08ef3cd75d82

Contract section

Id
ai/ai/contract#post-v1run
Repository
ai
Path
apps/cloudflare/workers/api/ai/CONTRACT.md
Commit
972a1c15b9d5
Version documented
2.37.0
Version live
2.14.0
Updated 2026-10-10.