Decisions

Typed decisions from Jev: yes/no probabilities, choices, scores and image boxes.

Make a decision

POST

https://api.hoosha.com/v1

/decisions

Sends state and named questions to Jev and returns one typed answer per question, keyed by the question's name.

Make a decision › Request Body

Fields not listed here are rejected with 400 unsupported_parameter, except fields sent as null.

DecisionRequest

model

string · enum · required

A decision model id.

Enum values:

jev-1.14

required

The content to evaluate, as a string or a JSON object or array.

object · minProps: 1 · maxProps: 64 · required

Questions keyed by a name you choose, 1 to 128 characters. Each answer comes back under the same name.

object · minProps: 1 · maxProps: 16

Images keyed by the reference string you write wherever the image belongs in state, instructions or criteria. Every asset must be referenced at least once.

user

string · maxLength: 256

An id for your end user. It is hashed before it reaches the model provider.

Make a decision › Responses

One typed answer per question, keyed by its name.

Decision

id

string · required

model

string · required

object · required

One answer per question, keyed by the question's name.

object · required

POST/decisions

curl https://api.hoosha.com/v1/decisions \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "model": "jev-1.14",
  "state": "I was charged twice for my subscription. Please refund the extra charge.",
  "questions": {
    "refund": {
      "type": "noul",
      "instructions": "Is the customer asking for money back?"
    },
    "team": {
      "type": "choice",
      "instructions": "Which team should handle this?",
      "criteria": {
        "billing": "Charges and refunds",
        "technical": "Bugs and outages"
      }
    },
    "urgency": {
      "type": "score",
      "instructions": "How urgent is this message?",
      "criteria": [
        "Can wait",
        "Needs attention this week",
        "Needs attention today"
      ]
    }
  }
}'

Example Request Body

{
  "model": "jev-1.14",
  "state": "I was charged twice for my subscription. Please refund the extra charge.",
  "questions": {
    "refund": {
      "type": "noul",
      "instructions": "Is the customer asking for money back?"
    },
    "team": {
      "type": "choice",
      "instructions": "Which team should handle this?",
      "criteria": {
        "billing": "Charges and refunds",
        "technical": "Bugs and outages"
      }
    },
    "urgency": {
      "type": "score",
      "instructions": "How urgent is this message?",
      "criteria": [
        "Can wait",
        "Needs attention this week",
        "Needs attention today"
      ]
    }
  }
}

json

application/json

Example Responses

{
  "id": "dec-3c1f0f6e2a444f6e9c2b8a1d5e77b901",
  "model": "jev-1.14",
  "answers": {
    "refund": {
      "type": "noul",
      "noul": 0.98
    },
    "team": {
      "type": "choice",
      "choice": "billing",
      "confidence": 0.9,
      "probabilities": {
        "billing": 0.95,
        "technical": 0.05
      }
    },
    "urgency": {
      "type": "score",
      "score": 1.7,
      "confidence": 0.55,
      "legend": {
        "0": "Can wait",
        "1": "Needs attention this week",
        "2": "Needs attention today"
      },
      "probabilities": {
        "0": 0.1,
        "1": 0.1,
        "2": 0.8
      }
    }
  },
  "usage": {
    "input_tokens": 412,
    "output_tokens": 30,
    "cost_credits": 0.0021
  }
}

json

application/json

Models

Make a decision

POST

https://api.hoosha.com/v1

/decisions

Sends state and named questions to Jev and returns one typed answer per question, keyed by the question's name.

Make a decision › Request Body

Fields not listed here are rejected with 400 unsupported_parameter, except fields sent as null.

DecisionRequest

model

string · enum · required

A decision model id.

Enum values:

jev-1.14

required

The content to evaluate, as a string or a JSON object or array.

object · minProps: 1 · maxProps: 64 · required

Questions keyed by a name you choose, 1 to 128 characters. Each answer comes back under the same name.

object · minProps: 1 · maxProps: 16

Images keyed by the reference string you write wherever the image belongs in state, instructions or criteria. Every asset must be referenced at least once.

user

string · maxLength: 256

An id for your end user. It is hashed before it reaches the model provider.

Make a decision › Responses

One typed answer per question, keyed by its name.

Decision

id

string · required

model

string · required

object · required

One answer per question, keyed by the question's name.

object · required