API ReferenceEndpointsPublic API (v1)Summarize a Storefront Bot conversation

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.

POST
/v1/storefront-bot/conversations/{id}/summarize
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"
}