Get Bot Details

GET/api/v1/bot

Returns configuration details about the bot tied to this API key. Useful for rendering the bot's name, colors, and feature flags in your custom UI.

Required scope: read

Response

idstring

Unique bot identifier (UUID).

namestring

Display name of the bot.

welcome_messagestring

First message the bot sends when a conversation starts.

primary_colorstring

Hex color for the bot's widget UI (e.g. "#f97316").

selected_modelstring

AI model: "gemini", "openai", "anthropic", or "openrouter".

lead_capture_enabledboolean

Whether the bot captures visitor contact details.

lead_fieldsarray

Lead fields collected (e.g. ["name", "email", "phone"]).

calendar_scheduling_enabledboolean

Whether the bot can book meetings.

meeting_providerstring

"google", "calendly", or null.

response_languagestring

Forced reply language code, or "" for auto-mirror.

created_atstring

ISO 8601 creation timestamp.

Example

cURL

curl https://api.personaliai.com/api/v1/bot \
  -H "Authorization: Bearer chatty_sk_your_key"

200 OK:

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "Aria — Support Assistant",
  "welcome_message": "Hi! I'm Aria. How can I help you today?",
  "primary_color": "#f97316",
  "selected_model": "gemini",
  "lead_capture_enabled": true,
  "lead_fields": ["name", "email"],
  "calendar_scheduling_enabled": false,
  "meeting_provider": null,
  "response_language": "",
  "created_at": "2026-03-15T10:30:00Z"
}

Send a Message

List Leads