Create a new session | Neurologyca

curl -X POST https://engine.neurologyca.ai/session \
     -H "Content-Type: application/json" \
     -d '{
  "user": "user-demo",
  "tenant": "demo",
  "securityKey": "cosmic-kiwi",
  "query": "I want to evaluate my speech"
}'

{
  "sessionId": "787",
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIzNCIsInRlbmFudF9pZCI6IjAiLCJuYW1lIjoidXNlci1kZW1vIiwianRpIjoiYzA4N2ZkZGItYzA2Yi00MGIwLTkwNGQtY2EyZWQwZWE3NzBmIiwiZXhwIjoxNzc0MTI2NzU2LCJpc3MiOiJFbmdpbmllcm9zIiwiYXVkIjoiSW50ZXJuYWxDbGllbnRzIn0.WBNL4QLZO7FQt5ItpDlTHbWprlJStGJvqYBP94JRrCU",
  "steps": [
    {
      "type": "Baseline",
      "order": 1,
      "stimulusUrl": "string"
    },
    {
      "type": "Video",
      "order": 2,
      "stimulusUrl": "https://kpnblobusw3.blob.core.windows.net/stimuli/demo_mobile.mp4?se=2026-04-01T02%3A38%3A07Z&sp=r&sv=2026-02-06&sr=b&sig=Zkl1zeSF2hW11TNqfg9kwtIN3kE67d3WHkywaw10f4Y%3D"
    },
    {
      "type": "Answer",
      "order": 3,
      "stimulusUrl": "string"
    }
  ]
}

Authenticates a tenant and a user with a security key. Returns a JWT bearer token for subsequent requests, the new session ID, and the ordered list of steps to follow.

Request

Authentication credentials and optional session context.

userstring or nullOptional

tenantstring or nullOptional

securityKeystring or nullOptional

querystring or nullOptional

callbackUrlstring or nullOptional

Response

Session created successfully.

sessionIdstring

tokenstring

stepslist of objects

Errors

400

Bad Request Error

401

Unauthorized Error