API reference
KYE Protocol™ Sandbox API
1 operations · sandbox.yaml
Public sandbox surface for sandbox.kyeprotocol.com (Cloudflare Pages Functions). No authentication — this is the try-before-signup playground. Every endpoint is a THIN demo adapter over the ONE canonical engine behind the authenticated production surface (§0: zero sandbox-local decision logic), runs against a fixed demo tenant (kye:tenant:sandbox-demo), persists nothing, and marks every response demo: true. The production Authority API is POST https://app.kyeprotocol.com/api/v1/runtime/evaluate (app-post-runtime-evaluate — the app-surface projection of the Core wire-contract op evaluateRuntime).
Playground
POST/api/v1/pdp/decideDemo three-outcome authority decision (public playground)
Evaluates one agent action through the SAME deterministic three-outcome decision engine as the authenticated Authority API (allow | require_approval | deny; reason codes from public/vocabulary/reason-codes.md). Fixed demo tenant, nothing persisted, deterministic decision_id per input, sealed Evidence Pack included so visitors can verify it offline.
Request body (required)
| field | type | description |
|---|---|---|
subject required | string | KYE™ URN of the acting agent (alias `agent` accepted). |
action required | string | Dotted lowercase capability id, e.g. payments.transfer. |
purpose required | string | |
context | object |
Responses
200Demo decision + patent-safe evidence + sealed Evidence Pack400invalid_json | missing_subject | subject_not_kye_urn | missing_action | action_malformed | missing_purpose