Skip to content

HTTP API reference

TypeSafe's official reference for the POST /v1/systemone request and response contract used by Jev.

Articleproduction

This summary is based on how curated lists describe the project; its README was not available to review.

Overview

This is TypeSafe's HTTP API reference page for Jev. It documents the request and response contract for POST /v1/systemone, the single endpoint where a client sends unstructured state together with typed questions and receives a probability for each allowed answer.

It is the primary reference for anyone writing a client, SDK or integration rather than using an existing one. The listing only summarises it as the request and response contract, so specifics such as field names, limits, error codes and versioning should be read directly on docs.typesafe.ai.

What the decision model decides

TypeQuestionAnswers
OtherDocuments how Choice, Score and Noul questions are encoded and answered over HTTP(inferred)—

How it works

  1. Read the request schema for state and questions
  2. Send POST /v1/systemone with an API key
  3. Parse per-answer probabilities from the response

Strengths

  • Authoritative contract for building clients in any language
  • Single endpoint keeps integrations simple

Caveats

  • Documentation only; details must be read on the site
  • Using the endpoint requires a TypeSafe account and key

At a glance

Type
Article
Status
production
Runtime
HTTP API
Has code
no

Use cases and integrations

How curated lists describe it

Frequently asked questions

What does this page cover?

The request and response format for POST /v1/systemone, Jev's decision endpoint.

Who should read it?

Anyone writing their own client, SDK or integration for Jev.

Do I need a key to call the endpoint?

Yes, calls require a TypeSafe API key.

Related projects

  • Server behind api.typesafe.pro, a free anonymous System One-compatible endpoint that forwards to TypeSafe on the operator's key.

    Serviceproduction
  • Browser form for building Jev requests from pasted text without hand-writing JSON, then rerunning to see how steady the answers are.

    ProjectbetaJavaScript
  • Terminal REPL for shaping System One requests before writing code, with lessons, a sketch editor, conversation turns and offline simulation.

    ServicebetaTypeScript
  • Nushell module for TypeSafe's System One API: pipe content in, ask noul, choice and score questions, and filter on the numbers.

    ServicebetaNushell
  • One-page playground and test bench for Jev with TypeSafe, OpenRouter, LLM-baseline and mock backends behind one /v1/systemone contract.

    ServiceprototypeTypeScript
  • Static browser interface for making structured Jev decisions through the Pollinations API, with multilingual READMEs.

    ServiceprototypeJavaScript