Evaluate decision models (TypeSafe-compatible)
Beta API. Telnyx controls model selection.
Evaluate shared context using named choice, noul (yes/no), and score questions. Returns TypeSafe System One-compatible answer shapes, an opaque compatibility identifier, and token usage. See the decision model guide for examples and compatibility limits.
The supported request subset requires instructions for every question, string descriptions for criteria (or null for choice descriptions), 1–64 questions, and 2–64 options for choice and score questions. The SDK-supplied model value is ignored and cannot select a model. Other unknown fields are rejected. The endpoint is synchronous and does not stream.
Use the TypeSafe Python SDK with base_url set to https://api.telnyx.com/v2/ai/typesafe and a Telnyx API key. The SDK appends /v1/systemone. Compatibility covers this operation and the documented request subset; it does not include TypeSafe model listing. Scores describe relative preference, not calibrated correctness.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Decision Models beta request. Telnyx manages model selection. SDK-supplied model values are ignored for compatibility; they do not select a model.
Response
All questions evaluated successfully. The response is a complete JSON object, not a stream.
A complete synchronous evaluation. Answers are returned directly without a data wrapper.
Opaque Telnyx-controlled identifier retained for TypeSafe SDK response compatibility. It is not a selectable model name or a guarantee of a particular underlying model.
Answers keyed by exactly the question IDs in the request. Each answer type matches its question.
Token usage for the completed evaluation.