---
title: "Facts about the business the customer stated in this chat that are not saved yet (one small AI call, metered in Build Credits); nothing is saved until the customer accepts them"
method: POST
path: "/builder/sessions/{sessionId}/knowledge/propose"
tags: ["Builder"]
---

# Facts about the business the customer stated in this chat that are not saved yet (one small AI call, metered in Build Credits); nothing is saved until the customer accepts them

`POST /builder/sessions/{sessionId}/knowledge/propose`

## Request

- Base URL: `https://hostingsurge.com/api/v1`
- URL: `https://hostingsurge.com/api/v1/builder/sessions/{sessionId}/knowledge/propose`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `__Host-hs_session`

## Path parameters

- `sessionId` string, uuid, required

## Response `200`

The proposal

- object
  - `proposal` object, required: Only facts the customer stated that are not saved yet; empty when there is nothing new
    - `name` string
    - `what` string: What the business does and offers
    - `audience` string: Who its customers are
    - `location` string: Where: address, area served
    - `hours` string: Opening hours
    - `prices` string: Prices, packages, menus
    - `voice` string: Brand voice: how the texts should sound
    - `avoid` string: Words or claims never to use
    - `mustHaves` string: What every version of the site must keep
    - `notes` string: Anything else, in the customer's words
  - `credits` number, required

## Other responses

- `400`: Invalid request (code invalid_request; details.reason: unsupported, too_large, unreadable, no_text, reference_gone)
- `401`: Missing or invalid session/token (code unauthorized)
- `402`: No Build Credits left, or the team's daily credits are used (code limit_reached)
- `403`: Authenticated but not permitted (code forbidden; details.reason private_beta or role)
- `404`: Not found or not visible to the caller (code not_found)
- `409`: Refused for now (code conflict; details.reason: plan_building, plan_dismissed, plan_empty, refines_used, figma_connect, archived, stale)
- `429`: Too many requests (code rate_limited; details.reason mode_rate, daily_budget, provider_busy); see Retry-After
- `501`: Not available on this server (code not_configured; details.reason capture_off, figma_off, migration_pending)
- `503`: The AI did not answer (code provider_unavailable); nothing was charged for the failed try

---

[API](https://skmtc.dev/hostingsurge/apis/hostingsurge-platform-api.md) · [All operations](https://skmtc.dev/hostingsurge/apis/hostingsurge-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hostingsurge/apis/hostingsurge-platform-api/revisions/4d08337cdff1?raw)