BoltReply.io API

The BoltReply.io API lets a signed-in business generate on-brand replies to customer reviews and manage the settings that guide those replies. BoltReply.io is a GrowLocal product for review-response workflows, not an AI receptionist or general writing API.

Start with the OpenAPI specification

Use the OpenAPI 3.1 JSON specification for operation IDs, request bodies, response schemas, authentication requirements, and error formats. A YAML version is also available for tooling that prefers it.

Base URL

https://www.boltreply.io

Authenticated operations are under /api/v1. Public demo tools are under /api/tools and are rate limited.

Primary operation

POST /api/v1/ai/generate (generateReviewReply) drafts a reply using the signed-in business's saved profile or Pro Mode prompts.

{
  "review_text": "The staff was kind but our order took too long.",
  "review_rating": 3,
  "mode": "simple"
}

The request requires Authorization: Bearer <supabase_access_token>. Read Authentication before calling it.

Public demo operations

• POST /api/tools/ai-review-answer-generator (generatePublicReviewReply) generates a limited public demo reply.
• POST /api/tools/prompt-generator (generatePublicPrompt) generates starter prompts for a business.

Public tools are for evaluation, not bulk production traffic. For account-specific brand voice and credits, use the authenticated API.

Errors and recovery

Every documented API error is JSON. It includes success: false, a stable code, an error message, a recovery hint, and docs_url. Unknown /api/* paths return the same format rather than an HTML page. Compare a failing request with the OpenAPI operation and use the provided hint before retrying.

For help, contact admin@boltreply.io.