Create a demo sandbox key

POST

/v1/demo/sandbox-key

POST

/v1/demo/sandbox-key

$ curl -X POST https://api.loreos.app/v1/demo/sandbox-key \
>      -H "Content-Type: application/json" \
>      -d '{}'

1 {
2   "schema_version": "v0",
3   "data": {
4     "api_key": "ck_demo_returned_once_secret",
5     "prefix": "ck_demo_",
6     "key_kind": "demo",
7     "app_id": "00000000-0000-0000-0000-000000000000",
8     "environment": "sandbox",
9     "expires_at": "2026-06-19T09:03:46Z",
10     "limits": {
11       "ttl_seconds": 3600,
12       "credit_limit": 1,
13       "characters": 1,
14       "sessions": 3,
15       "messages": 20,
16       "max_input_chars": 4000,
17       "image_generation": false,
18       "telegram": false,
19       "webhooks": false
20     },
21     "note": "demo keys are for local testing only; use a persistent developer key for production"
22   },
23   "next_actions": [
24     {
25       "command": "POST /v1/characters",
26       "description": "Create one sandbox character"
27     },
28     {
29       "command": "GET /v1/rates",
30       "description": "Inspect metering and hard-cap behavior"
31     }
32   ]
33 }

Issue a short-lived sandbox API key for no-key docs dogfood.

The route creates an isolated sandbox tenant/app/key with an app hard cap so metered work is blocked locally before provider spend. The raw key is returned once. Operators disable public issuance with DB Runtime Control demo.sandbox=disabled; LOREOS_DEMO_SANDBOX_ENABLED is fallback only.

Request

This endpoint expects a nullable object.

fingerprintstring or nullOptional<=256 characters

turnstile_tokenstring or nullOptional<=4096 characters

Response

Successful Response

schema_version"v0"

LoreOS success-envelope version.

dataobject

next_actionslist of objects

Concrete follow-up API actions; empty when no action is required.

Errors

422

Unprocessable Entity Error