Virtual Assistants (/api/v1/bot)

RiskInMind provides several specialized AI Virtual Assistants (Bots) designed to handle specific financial queries and interactions.

Chat with an Assistant

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

Authentication

• ava — No auth required (public entrypoint).
• erina, david, sean, mark — Authentication required via X-API-Key. Consumes credits (AI_CHAT).

Available Assistants

Bot	Auth	Specialty
Ava	None	General financial assistant and navigation guide
Erina	Required	Loan processing and documentation requirements
David	Required	Regulatory compliance and fair lending
Sean	Required	Commercial Real Estate (CRE) analysis
Mark	Required	Consumer credit and risk factor analysis

Request Body

Parameter	Type	Description
message	String	(Optional) Current user message string
messages	Array	(Optional) Full message history with role and content properties
session_id	String	(Optional) Session identifier for maintaining conversation context

{
  "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?" }
  ],
  "session_id": "session-uuid"
}

cURL

# Ava — no auth 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?",
    "session_id": "session-uuid",
    "messages": [
      { "role": "user", "content": "Hello Ava" },
      { "role": "assistant", "content": "Hello! How can I help you today?" }
    ]
  }'

# Other bots — include X-API-Key
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?"
  }'

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();

Response

• Content-Type: application/json
• Returns: AI assistant response object or string depending on bot configuration.