Authentication

The hosted API uses one public header: X-API-Key.

Anonymous access is available for lightweight evaluation. Keyed access expands the hosted quota and unlocks usage inspection through GET /api/v1/usage.

Hosted tiers

Tier	Quota	How to get it
Anonymous playground	Small private-beta quota	Call POST /api/v1/solve directly
Evaluation key	Larger private-beta evaluation window	Issue it via POST /api/v1/request-key
Starter	Request-based beta terms	Request hosted access via Pricing
Pro	Request-based beta terms	Request hosted access via Pricing
Scale	Request-based beta terms	Request hosted access via Pricing

The free tiers are intentionally sized for evaluation, smoke tests, and early integration work.

Issuing the free evaluation key

{
  "email": "[email protected]",
  "plan": "free"
}

curl -X POST https://api.cutweaver.io/api/v1/request-key \
  -H "Content-Type: application/json" \
  -d @request_key_free.json

{
  "ok": true,
  "contractVersion": "v1",
  "key": "cnw_free_xxxxxxxxxxxxxxxxxxxxxxxx",
  "email": "[email protected]",
  "plan": "free",
  "newlyIssued": true
}

The same normalized email returns the same active key instead of creating duplicates.

Sending the key

curl -X POST https://api.cutweaver.io/api/v1/solve \
  -H "X-API-Key: cnw_pro_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d @request.json

Checking your usage

curl https://api.cutweaver.io/api/v1/usage \
  -H "X-API-Key: cnw_pro_xxxxxxxxxxxxxxxxxxxxxxxx"

{
  "ok": true,
  "contractVersion": "v1",
  "key": "cnw_pro_xxxxxxxxxxxxxxxxxxxxxxxx",
  "plan": "pro",
  "period": "2026-04",
  "usage": { "solves": 1247, "limit": 15000 }
}

Info

This page describes the hosted API authentication contract. Exact beta limits are intentionally not published until production launch. Dedicated deployments are provisioned directly and are not required to use the hosted key-issuance flow.