BearForge API Console · early access

BearForge API Console

Early access. The first publicly available Skill is Bear Brain. The rest of the Skill catalog is listed here for transparency; their endpoints are not wired in this round.

Preliminary guidance only. No checkout, no charge, no card on file. PDF/DWG/DXF/SVG export and permit-ready output remain locked.
Current runtime: web  ·  Future developer domain: bearforge.io (not yet live)
What you can do today
The console is framework-first. Bear Brain Skill is live; other tabs lay the groundwork for upcoming rounds.
Bear Brain Skill is the first live Skill. Send a POST /api/skills/bear-brain/chat with a message field and receive a 5-block structured response wrapped with locked-output flags. See Docs for a curl example.
API Keys can be created from the API Keys tab once you are signed in. Anonymous key creation is not permitted. Keys are prefixed bf_test_…; the raw value is shown exactly once.
Other Skills (Bear Zoning, Bear Designer, Bear Printer, Bear PE) are listed in the Skills tab with their locked or reserved status so the roadmap is visible. None of them have callable endpoints in this round.
API Keys
API keys are for Bear Brain Skill early access. Designer, Printer, PE, PDF/DWG/DXF/SVG, verified zoning, and permit-ready scopes are locked.
Scopes available in v1:
  • bear_brain:chat — call /api/skills/bear-brain/chat
  • pricing:estimate — call /api/pricing/estimate
  • projects:read — read your own projects (when wired)
Reserved (cannot be granted in v1): projects:write.
Locked (Skill not callable): printer:*, designer:*, pe:*, zoning:*.
Skills
All BearForge Skills, with their current status. Only available and preview Skills have callable endpoints.

Bear Brain

Available

Customer-facing architectural intelligence and preliminary guidance.

POST /api/skills/bear-brain/chat

Bear Pricing

Preview

Pricing estimate only, no checkout.

POST /api/pricing/estimate

Bear Zoning

Locked

Verified zoning analysis. Reserved for verified zoning upgrade round.

reserved for verified zoning upgrade

Bear Designer

Locked

Design generation. Reserved for future design generation round.

reserved for future design generation

Bear Printer

Locked

Formal output renderer (PDF/DWG/DXF/SVG). Formal output is locked.

formal output locked

Bear PE

Reserved

PE window / approved-plan upload workflow.

future PE window / approved-plan upload workflow

Usage
Per-member API call counters. Charges are disabled during early access — no charge, no checkout, no card on file.
Current period: — Bear Brain calls  ·  Plan: free_test  ·  Member: —
Paid Bear Brain calls deduct API credits from your wallet.
If your balance is insufficient, the call will not run.
Designer workflows are locked and will have separate credit rates when available.
Receipts are available in your API Console. No receipt email.
Live counters: /api/billing/usage  ·  Event log: /api/billing/usage/events
Limits
Guest quota and rate limits in effect today.
Guest chat: 10 requests / minute, approximately 20 requests / day (cost-budgeted). See X-BearForge-Guest-Quota-Enabled response header.
Member / Pro limits are reserved for a future round and not yet differentiated from Guest.
Projects
Project IDs (BFP-YYYYMMDD-XXXXXX) bound to Member ID. v1 framework only.
The Project schema is live (see core/projects/). Endpoints for listing / creating / managing projects are not yet wired in the API Console — they ship in the next round, bearforge_project_id_and_pe_window_contract_v1.
Webhooks
Outbound webhook configuration. Reserved for a future round.
No webhook subscriptions are accepted in v1.
Billing
BearForge API uses prepaid credits. No membership fee.
How BearForge API billing works:
  • Top up credits before using paid API calls.
  • Each Bear Brain API call deducts credits from your wallet.
  • Designer and high-compute workflows will use separate credit rates when available.
  • If your balance is insufficient, the API call will not run.
  • No membership fee. No subscription required.
  • Receipts are available in your API Console.
Wallet balance
Current balance: —  ·  Currency: usd  ·  Member: —
Paid API calls require API credits. Top up using the buttons below.
Live wallet: /api/billing/wallet  ·  Credit transactions: /api/billing/transactions
Top-up credits Checkout Disabled
Available top-ups: $20 / $30 / $50. Future custom amounts coming later.
Top-up checkout is currently disabled.
Receipts & history
Receipts are available in your API Console. No receipt email.
JSON list: /api/billing/receipts · Status probe: /api/billing/status
Security
Auth, session, key storage, and locked-output policy notes.
Auth: email magic-link, no passwords. Sessions are signed cookies, HTTPOnly + SameSite=Lax. Magic-link tokens expire after 15 minutes and are single-use; only the SHA-256 hash is persisted.
API key storage: only the SHA-256 hash of each key is persisted. The raw value is returned exactly once at creation. Revoked keys cannot be used. Locked-skill scopes (printer:*, designer:*, pe:*, zoning:*) cannot be granted.
Locked outputs: PDF, DWG, DXF, SVG export are locked. Permit-ready output, verified-zoning final result, final-setback certification are not enabled. BearForge produces preliminary guidance only.