Summarize a Storefront Bot conversation
Summarizes a conversation with AI and stores the summary. Conversations of 10 messages or fewer are not summarized and cost no credits.
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
Path Parameters
idstring
Conversation id
curl -X POST "https://api.brainerce.com/api/v1/storefront-bot/conversations/string/summarize"{
"summarized": true,
"summary": "Customer asked about sizing and chose size M."
}{
"statusCode": 401,
"code": "UNAUTHORIZED",
"message": "Invalid or expired credential",
"timestamp": "2026-08-23T10:15:00.000Z",
"path": "/api/v1/storefront-bot/conversations/{id}/summarize"
}{
"statusCode": 402,
"code": "PLAN_AI_CREDITS_EXHAUSTED",
"message": "AI credit balance exhausted for this billing period",
"timestamp": "2026-08-23T10:15:00.000Z",
"path": "/api/v1/storefront-bot/conversations/{id}/summarize"
}{
"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/conversations/{id}/summarize"
}{
"statusCode": 404,
"code": "RESOURCE_NOT_FOUND",
"message": "Resource not found",
"timestamp": "2026-08-23T10:15:00.000Z",
"path": "/api/v1/storefront-bot/conversations/{id}/summarize"
}{
"statusCode": 429,
"code": "RATE_LIMITED",
"message": "Too many requests",
"details": {
"retryAfterSeconds": 12
},
"timestamp": "2026-08-23T10:15:00.000Z",
"path": "/api/v1/storefront-bot/conversations/{id}/summarize"
}