Skip to main content

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​

BotAuthSpecialty
AvaNoneGeneral financial assistant and navigation guide
ErinaRequiredLoan processing and documentation requirements
DavidRequiredRegulatory compliance and fair lending
SeanRequiredCommercial Real Estate (CRE) analysis
MarkRequiredConsumer credit and risk factor analysis

Request Body​

ParameterTypeDescription
messageString(Optional) Current user message string
messagesArray(Optional) Full message history with role and content properties
session_idString(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"
}
# 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?"
}'

Response​

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