BrainerceGet Storefront Bot settings for every connection on the store
Returns the Storefront Bot settings of every sales channel connection of the store. Connections that were never configured show the defaults.
AuthorizationBearer <token>
Admin API key (server-to-server). Issue via the dashboard at Settings → API keys. Plain-text key is shown once — store in a secret manager. Format: Authorization: Bearer brainerce_xxxxxxxxx.
In: header
curl -X GET "https://api.brainerce.com/api/v1/storefront-bot/settings"{
"connections": [
{
"salesChannelId": "clx1a2b3c4d5e6f7g8h9",
"connectionId": "vc_9f3a2b1c8d7e6f5a",
"name": "My storefront"
}
],
"settings": [
{
"salesChannelId": "clx1a2b3c4d5e6f7g8h9",
"connectionId": "clx1a2b3c4d5e6f7g8h9",
"name": "Maya",
"enabled": true,
"displayName": "Assistant",
"avatarUrl": "https://cdn.example.com/bot/maya.png",
"personaJson": {
"greeting": "string",
"tone": "friendly",
"accentColor": "string",
"responseLength": "concise",
"emoji": true,
"bubbleShape": "rounded",
"displayMode": "floating",
"position": "start",
"allowExpand": true,
"customInstructions": "string",
"faqs": [
{
"q": "string",
"a": "string"
}
],
"capabilities": {
"productQa": true,
"recommendations": true,
"orderTracking": true,
"returns": true,
"bundleNudges": true
},
"languages": [
"en"
],
"starterQuestions": [
"string"
],
"avoidTopics": "string",
"maxDiscountPct": 0,
"minRecommend": 0,
"restrictLanguages": true,
"storeFacts": true,
"knowledgePageIds": [
"string"
],
"rules": [
{
"kind": "always",
"text": "string"
}
],
"memory": {
"enabled": true,
"kinds": [
"size"
],
"days": 0,
"consentMode": "ask"
}
},
"escalationJson": {},
"retentionJson": {
"days": 0
},
"localeJson": {},
"dailySpendCeilingUsd": 5
}
]
}{
"statusCode": 401,
"code": "UNAUTHORIZED",
"message": "Invalid or expired credential",
"timestamp": "2026-08-23T10:15:00.000Z",
"path": "/api/v1/storefront-bot/settings"
}{
"statusCode": 403,
"code": "INSUFFICIENT_SCOPE",
"message": "API key does not have the required scope: products:write",
"timestamp": "2026-08-23T10:15:00.000Z",
"path": "/api/v1/storefront-bot/settings"
}{
"statusCode": 429,
"code": "RATE_LIMITED",
"message": "Too many requests",
"details": {
"retryAfterSeconds": 12
},
"timestamp": "2026-08-23T10:15:00.000Z",
"path": "/api/v1/store"
}