API· Last updated 2026-09-21

Your first Jev API call

Get a key from the TypeSafe dashboard, export it, then:

curl -X POST https://api.typesafe.ai/v1/systemone \
  -H "Authorization: Bearer $TYPESAFE_API_KEY" \
  -H "Content-Type: application/json" \
  -d @- <<'EOF'
{
  "state": "Hi, I've been trying to connect my Stripe account for 3 days and the integration keeps failing. I'm losing sales. Please help ASAP.",
  "model": "jev-latest",
  "questions": {
    "urgency": {
      "type": "noul",
      "instructions": "Does this message express urgency?"
    }
  }
}
EOF

That is the official quick-start request, slightly compacted. The documented response includes a resolved model (for example jev-1.13.0), answers.urgency.noul, and usage.

Then add two more questions

The same quick start shows mixing Choice, Score, and Noul in one body: department, frustration, urgency. You do not need three HTTP calls.

Python equivalent

pip install typesafe-sdk

TypeSafeClient() reads TYPESAFE_API_KEY and defaults to jev-latest. See Python SDK.

If it fails

Never commit a real key. This site will never give you one.