Skip to navigation
BeatAPICoreDecisions

Answer typed decision questions with JEV

Synchronous native decision endpoint. Send shared state and named noul, choice, or score questions; read id, model, answers, and usage directly from the response (no data envelope and no task polling). Nouls require instructions; score accepts 1-10 criteria. The paid model is billed by input tokens; the free model is rate limited. Inspect the selected model for current availability and pricing. This is the direct equivalent of capabilities/run with reference model:jev-1.13 or model:jev-1.13-free.

Authentication

AuthorizationBearer

Send your API key as Authorization: Bearer <BEATAPI_API_KEY>.

Request

This endpoint expects an object.
statestring or map from strings to any or list of anyRequired
Shared application state. Billed once across all named questions.
questionsmap from strings to objectsRequired
modelstringOptionalDefaults to jev-1.13

Use a published decision model, such as jev-1.13 or jev-1.13-free.

streambooleanOptional

Only false is supported; decisions are synchronous and never stream.

Response

Completed decision; no polling is required.

idstring
Identifier for the completed decision.
modelstring
answersmap from strings to objects
One typed answer per question name, without a data envelope.
usageobject

Errors

400
Bad Request Error
401
Unauthorized Error
402
Payment Required Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error