Evaluate state with TypeSafe Jev

Evaluate state with TypeSafe Jev through Respan.

Required credentials — enter both keys:

Respan API key (required): enter your Respan key in the Authorization control.
TypeSafe API key (required unless saved in Settings > Providers): use the default Enter TypeSafe API key form and open its first field, respan_params → credential_override → jev-1.13.0 → api_key and replace YOUR_TYPESAFE_API_KEY with your TypeSafe key.

The credential override uses the model name without typesafe/: jev-1.13.0 for typesafe/jev-1.13.0. If your TypeSafe key is already saved in Settings > Providers, select Use saved TypeSafe key and remove the example’s respan_params.credential_override block to use that saved key. TypeSafe does not use Respan gateway credits.

Send model, state, and a map of named questions. Respan removes the typesafe/ model prefix and respan_params before forwarding the request. The TypeSafe JSON response is returned unchanged, with answers keyed by question name. Streaming is not supported; stream: true returns HTTP 400.

The refund example uses noul, which returns a probability between 0 and 1. For more on the question types, see the TypeSafe API reference.

TypeSafe may return HTTP 429 for rate limits or HTTP 529 when overloaded. Retry these responses with exponential backoff.

Evaluate state with TypeSafe Jev through Respan. **Required credentials — enter both keys:** 1. **Respan API key (required):** enter your Respan key in the **Authorization** control. 2. **TypeSafe API key (required unless saved in Settings > Providers):** use the default **Enter TypeSafe API key** form and open its first field, `respan_params` → `credential_override` → `jev-1.13.0` → `api_key` and replace `YOUR_TYPESAFE_API_KEY` with your TypeSafe key. The credential override uses the model name without `typesafe/`: `jev-1.13.0` for `typesafe/jev-1.13.0`. If your TypeSafe key is already saved in Settings > Providers, select **Use saved TypeSafe key** and remove the example's `respan_params.credential_override` block to use that saved key. TypeSafe does not use Respan gateway credits. Send `model`, `state`, and a map of named `questions`. Respan removes the `typesafe/` model prefix and `respan_params` before forwarding the request. The TypeSafe JSON response is returned unchanged, with answers keyed by question name. Streaming is not supported; `stream: true` returns HTTP 400. The refund example uses `noul`, which returns a probability between 0 and 1. For more on the question types, see the [TypeSafe API reference](https://docs.typesafe.ai/api). TypeSafe may return HTTP 429 for rate limits or HTTP 529 when overloaded. Retry these responses with exponential backoff.

Authentication

AuthorizationBearer

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, provider credentials such as Perplexity, OpenAI, or Azure OpenAI go in Settings -> Providers or respan_params.credential_override in the request body, not in this authentication field.

Request

This endpoint expects an object.

Enter TypeSafe API keyobjectRequired

Provide both keys for this request. Enter the Respan key in Authorization and the required TypeSafe key below.

Use saved TypeSafe keyobjectRequired

Use a TypeSafe provider key already configured in Respan Settings > Providers. No request-scoped key is required.

Response

TypeSafe evaluation result. The example is from the refund request; probabilities and token counts can vary.

modelstring

Model identifier returned by TypeSafe.

answersmap from strings to objects

Results keyed by the names supplied in questions.

usageobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

422

Unprocessable Entity Error

429

Too Many Requests Error

Evaluate state with TypeSafe Jev through Respan.

Required credentials — enter both keys:

Respan API key (required): enter your Respan key in the Authorization control.
TypeSafe API key (required unless saved in Settings > Providers): use the default Enter TypeSafe API key form and open its first field, respan_params → credential_override → jev-1.13.0 → api_key and replace YOUR_TYPESAFE_API_KEY with your TypeSafe key.

The refund example uses noul, which returns a probability between 0 and 1. For more on the question types, see the TypeSafe API reference.

TypeSafe may return HTTP 429 for rate limits or HTTP 529 when overloaded. Retry these responses with exponential backoff.