Virtual Assistants (/api/v1/bot)

RiskInMind provides several specialized AI Virtual Assistants (Bots) designed to handle specific financial queries and interactions. These bots leverage advanced LLMs via our internal bot service.

Chat with an Assistant

• Method: POST
• Endpoint: /api/v1/bot/:botName
• Path Param: botName — ava, erina, david, sean, or mark

Authentication

• ava — No API key or token required (public entrypoint).
• erina, david, sean, mark — Required: X-API-Key or Bearer / cookie session (see Introduction).
• Headers:
  • X-API-Key: <your_api_key> (Not required for ava)
  • Content-Type: application/json

Available Assistants

• Ava: General financial assistant and navigation guide (unauthenticated).
• Erina: Specialist in loan processing and documentation requirements.
• David: Regulatory compliance and fair lending expert.
• Sean: Commercial Real Estate (CRE) analysis specialist.
• Mark: Consumer credit and risk factor analyst.

Request Body

Parameter	Type	Description
message	String	(Optional) The current user message string.
messages	Array	(Optional) Full message history with role and content properties.

JSON Schema

{
  "message": "What is the status of my loan application?",
  "messages": [
    { "role": "user", "content": "Hello Ava" },
    { "role": "assistant", "content": "Hello! How can I help you today?" }
  ]
}

cURL

# Ava — no auth header required
curl -X POST https://api.riskinmind.ai/api/v1/bot/ava \
  -H "Content-Type: application/json" \
  -d '{
    "message": "What is the status of my loan application?",
    "messages": [
      { "role": "user", "content": "Hello Ava" },
      { "role": "assistant", "content": "Hello! How can I help you today?" }
    ]
  }'

# Other bots — include X-API-Key or session auth
curl -X POST https://api.riskinmind.ai/api/v1/bot/erina \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "What documents do I need for a consumer loan?"
  }'

Python

import requests

url = "https://api.riskinmind.ai/api/v1/bot/erina"
headers = {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
data = {
    "message": "What documents do I need for a consumer loan?",
    "messages": [
        {"role": "user", "content": "Hello Erina"}
    ]
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

JavaScript

const response = await fetch('https://api.riskinmind.ai/api/v1/bot/erina', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    message: "What documents do I need for a consumer loan?",
    messages: [
      { role: "user", content: "Hello Erina" }
    ]
  })
});

const data = await response.json();
console.log(data); // e.g. "For a consumer loan, you typically need..."

Response

• Content-Type: application/json or text/plain depending on the bot config.
• Returns: A string response from the specified AI assistant.