First call (curl)

Note

This page assumes you already have an API key.

You can generate one in the SotsAI Admin page.

Base URL

https://sil-api.sotsai.co

All endpoints are prefixed with /v1.

1) Set your API key

SotsAI authenticates using an API key header:

Header: "X-Sotsai-Api-Key: <your_key>"

2) Make your first call

Note

This is a minimal example.

In production, you should pass structured context and profiles consistently. SotsAI requires a user psychometric profile. If you don’t have one, your LLM should handle the request without calling SotsAI.

curl -X POST "https://sil-api.sotsai.co/v1/advice" \
  -H "Content-Type: application/json" \
  -H "X-Sotsai-Api-Key: <YOUR_API_KEY>" \
  -d '{
    "context_summary": "The user needs to give corrective feedback to a direct report who keeps missing deadlines. The user wants to be firm without demotivating the direct report.",
    "relationship_type": "direct_report",
    "user_profile": {
      "tool": "disc",
      "raw_scores": {
        "natural": { "D": 78, "I": 64, "S": 22, "C": 36 },
        "adapted": { "D": 70, "I": 58, "S": 30, "C": 42 }
      }
    },
    "interlocutor_profile": {
      "tool": "disc",
      "raw_scores": {
        "natural": { "D": 18, "I": 32, "S": 70, "C": 76 },
        "adapted": { "D": 22, "I": 28, "S": 74, "C": 80 }
      }
    }
  }'

Examples in Python and JavaScript are available in the Integration Guides.