System One

POSThttps://enterprise.blackbox.ai/typesafe/v1/systemone

Submit structured decisions to System One with Jev and typed questions.

System One evaluates supplied state against structured questions and returns typed answers for application workflows.

See Jev Examples & Tips for practical examples, question-design tips, and implementation recommendations.

Authentication

Pass your BLACKBOX API key as a Bearer token in the Authorization header. You can manage API keys from the BLACKBOX AI dashboard.

Headers

Authorizationstringrequired

Your BLACKBOX API key in the form Bearer <api_key>.

Content-Typestringrequired

Must be set to application/json.

Request Body

statestring | objectrequired

The text or structured data that Jev evaluates.

modelstringrequired

The Jev model to use. Use jev-latest for the latest stable release.

questionsobjectrequired

Named questions that define the decisions to return.

Question Object

typestringrequired

The question type: choice, score, or noul.

instructionsstring

A focused question or instruction describing the required judgment.

criteriaobject | array

Named options for choice, ordered levels for score, or true and false definitions for noul.

Example Request

Request Example

curl -X POST 'https://enterprise.blackbox.ai/typesafe/v1/systemone' \
  -H "Authorization: Bearer ${BLACKBOX_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "state": "The customer reports that checkout has failed for 20 minutes.",
    "model": "jev-latest",
    "questions": {
      "is_urgent": {
        "type": "noul",
        "instructions": "Does this issue require immediate attention?",
        "criteria": {
          "true": "The issue blocks an important production workflow",
          "false": "The issue does not require immediate action"
        }
      }
    }
  }'