{"api_version":"v0.5.18","endpoints":{"verify":"POST /v1/verify","activate_covenant":"POST /v1/covenants","authorize_covenant_action":"POST /v1/authorizations","record_outcome":"POST /v1/outcomes","audit_insights":"GET /v1/insights","audit_chain":"GET /v1/audit/chain","audit_chain_head":"GET /v1/audit/chain/head (public; hashes and counts only)","demand_funnel":"GET /v1/insights/funnel"},"demand_measurement_privacy":{"enabled":true,"purpose":"Measure first and repeat use of signed-grant enforcement.","scope":"Decisions made with a verified signed grant.","stored_fields":["A stable pseudonym derived from the grant issuer ID using a server-only HMAC key","UTC date","Daily ALLOW and other-decision counts","Internal-traffic exclusion flag"],"retention":"Scheduled pruning removes dates earlier than the 35-day cutoff.","access":"The authenticated demand report returns aggregate counts only.","details":"https://github.com/vassiliylakhonin/vizier/blob/main/docs/DEMAND_MEASUREMENT.md"},"content_type":"application/json","request_schema":{"agent":{"id":"string","owner":"string | null"},"principal":"{ id: string } | null","action":{"type":"string","target":"string","parameters":"JSON object","is_reversible":"boolean (optional; supplied assertion)"},"authority":{"allowed_actions":["string"],"constraints":{"max_amount":"number (optional)","currency":"ISO 4217 code (optional)","allowed_targets":["string (optional)"],"blocked_targets":["string (optional)"],"allowed_sensitive_actions":["string (optional)"],"require_review_for_irreversible":"boolean (optional)"}},"context":{"request_id":"string | null","timestamp":"ISO-8601 | null","source":"a2a | mcp | rest | internal | unknown"},"grant":"compact JWS signed by the principal, binding this exact authority to this agent (optional)"},"decisions":["ALLOW","REVIEW","BLOCK"],"enforcement":{"evaluation_mode":"No VIZIER_API_KEY: REVIEW or BLOCK only","authenticated_mode":"VIZIER_API_KEY configured: Bearer credential required for verification","covenant_mode":"VIZIER_API_KEY and RECEIPT_SIGNING_KEY configured: authenticated lifecycle with ES256 receipts","insights_mode":"VIZIER_API_KEY and D1 configured: authenticated metadata-only operational counts","delegation_mode":"VIZIER_PRINCIPAL_KEYS configured: a principal-signed grant is verified against a registered key, and the receipt records it"},"delegation":{"onboarding":{"signed_grant_mode":"required","grant_required":true,"authorization_available":true,"grant_field":"grant","credential_is_delegation":false,"example_is_synthetic":true,"example_arguments":{"agent":{"id":"example-agent","owner":"example-owner"},"principal":{"id":"example-owner"},"action":{"type":"purchase","target":"synthetic.example.invalid","parameters":{"amount":150,"currency":"USD"}},"authority":{"allowed_actions":["purchase"],"constraints":{"max_amount":1000,"currency":"USD"}},"context":{"request_id":"synthetic-onboarding-001","timestamp":"2026-10-09T00:00:00Z","source":"mcp"}},"next_steps":["Anonymous calls are evaluation-only and never grant ALLOW. An API key authenticates the integration; it is not principal delegation.","In required mode, missing grants return GRANT_REQUIRED. An invalid deployment policy returns GRANT_POLICY_MISCONFIGURED; the operator must repair configuration.","The principal owner generates an ES256 key outside the agent. Ask the operator to register only its public JWK under the principal id in VIZIER_PRINCIPAL_KEYS; check /docs delegation.principal_keys_valid and registered_principals.","The owner issues a short-lived compact ES256 grant bound to this principal, agent and exact authority. Keep the private key outside prompts, requests and the agent's control. Do not fabricate a grant or reuse the synthetic example as authority.","Submit the real grant with the verification request and an integration credential for enforcement. Only an actual ALLOW result at the protected execution boundary may proceed; BLOCK, REVIEW and errors must stop for review."],"documentation":"/docs"},"mode":"required","grant_required":true,"grant_field":"grant","grant_media_type":"compact JWS, typ vizier-delegation+jws, alg ES256","registered_principals":1,"principal_keys_configured":true,"principal_keys_valid":true,"authority_provenance":["principal_signed","trusted_integration","unverified"],"note":"Required mode blocks missing grants; invalid mode blocks all authorization. Optional mode permits caller-asserted authority. A grant that does not verify is BLOCK, never a downgrade to the caller-asserted path."},"machine_contracts":{"openapi_3_1":"/openapi.json","openapi_well_known_alias":"/.well-known/openapi.json","ai_catalog":"/.well-known/ai-catalog.json","agent_card":"/.well-known/agent-card.json","mcp_server_manifest":"/.well-known/mcp.json","receipt_keys":"/.well-known/jwks.json"},"examples":"/examples"}