Introduction

D1 turns a text or JSON context into decisions over outcomes you define. Use it to route a support request, select a tool, check an answer against its sources, or decide when a person should take over.

Make a decision

With an API key from the console, try a yes/no question:

export D1_API_KEY='your-api-key'

curl --fail-with-body https://console.sqwish.ai/v1/decide \
  -H "Authorization: Bearer $D1_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "sqwish-d1-core",
    "context": "My parcel arrived with a cracked mug. Please help.",
    "decisions": [{
      "id": "needs_help",
      "kind": "binary",
      "question": "Does the customer ask for help with an order?"
    }]
  }'

Read decisions.needs_help.p_yes for the yes score and decisions.needs_help.action for the selected action. Check model and any fallback to see which model answered. The quickstart covers account access and handling the result.

Three decision types

Kind	Use it to	Read from the result
Binary	Answer a yes/no question	`p_yes`, `probabilities`, `action`
Single	Choose one of your named outcomes	`probabilities`, `top`, `action`
Ordinal	Rate against ordered levels	`expected_level`, `median_level`, `probabilities`

Mix types in one request. Results are keyed by your decision IDs. Add an abstention policy when uncertain cases should go to review.

Probabilities describe the declared alternatives. They are not a guarantee that an answer is correct. Test your wording, labels and action thresholds on representative cases before using them to automate work.

From a first request to a better decision

Build an integration

Send a request, read an action, and handle failures.

Try a real workflow

Start with the same recipes used in the console playground.

Improve with your data

Review labels, tune wording and train a version.

Connect an agent

Use the repository skill or the MCP tools.

The API Reference tab describes current customer endpoints. Its interactive calls target console.sqwish.ai and can perform real work using the key you supply.

Get started

Using D1

Improve your decisions

Make a decision

Three decision types

From a first request to a better decision

Build an integration

Try a real workflow

Improve with your data

Connect an agent

​Make a decision

​Three decision types

​From a first request to a better decision

Build an integration

Try a real workflow

Improve with your data

Connect an agent

Make a decision

Three decision types

From a first request to a better decision