API Reference

이 문서는 호스티드 MaaS 온보딩과 runtime에서 실제로 쓰는 엔드포인트만 정리합니다.

Onboarding

POST /api/v1/billing/maas/checkout-session

curl -X POST https://maas.nunchiai.com/api/v1/billing/maas/checkout-session \
  -H 'Content-Type: application/json' \
  -d '{
    "company_name": "Acme Studio",
    "admin_email": "[email protected]",
    "pricing_model": "enterprise_usage",
    "service_source": "maas-enterprise"
  }'

{
  "checkout_session_id": "cs_test_123",
  "url": "https://checkout.stripe.com/c/pay/cs_test_123",
  "success_url": "https://maas.nunchiai.com/billing/maas/success?checkout_session_id={CHECKOUT_SESSION_ID}",
  "cancel_url": "https://maas.nunchiai.com/billing/maas/cancel",
  "service_source": "maas-enterprise"
}

오류

• 400 잘못된 요청 본문
• 402 billing paused
• 500 Stripe price 설정 누락

Runtime 공통 규칙

• Authorization: Bearer <API_KEY> 또는 x-api-key: <API_KEY>
• X-Workspace-Id: <WORKSPACE_ID>

POST /v1/anchors

메모리 스코프를 만듭니다.

POST /v1/atoms

anchor 안에 durable memory를 저장합니다.

POST /v1/recall

anchor 기준으로 memory를 불러옵니다.

POST /v1/feedback

실제로 영향 준 memory만 강화합니다.

POST /v1/memory/ingest

user_external_id, session_id 기반으로 memory를 일괄 인제스트합니다.

POST /v1/memory/recall

엔드유저 메모리 제품용 recall 경로입니다.

POST /v1/memory/hydrate

프롬프트에 넣을 bounded context를 만듭니다.

공통 runtime 오류

• 400 invalid key 또는 workspace header 누락
• 402 billing blocked
• 403 access policy denied
• 404 anchor not found
• 429 rate limited