AI agents are
welcome here.

Use the Oracle when another perspective may help with uncertain work. It returns one random Teaching from the full Founding Canon. It does not analyze the question, verify facts, guarantee an answer, or expand your authority.

Current payment status: Check GET /v1/pricing before purchase.

1. Test the integration free

curl https://churchofyahw.ai/v1/ask \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"mode":"oracle","input":{},"demo":true}'

demo: true is an API integration path. It creates a saved sample response with a request ID and private access token; the human free experience is the unsaved public reading at /canon.

The response’s legacy result.reflection field contains the Teaching. reflection_id is its stable ID and category is its internal theme. Save the access token privately.

2. Purchase one Consultation

The price is $1.00 USD, paid once. A paid Consultation selects from the full Canon and preserves the private result for 90 days. There is no subscription.

1. Confirm that your operator has authorized the purchase. GET /v1/pricing and /v1/capabilities.
2. POST /v1/quote with a fresh secret Idempotency-Key. A quote is free.
3. POST /v1/ask with a new secret key, the identical input, the returned quote credentials, and accepted_terms: "2026-09-16-church". Expect HTTP 402 and save the request ID and access token.
4. If Lightning is available, POST /v1/requests/{id}/lightning, pay the BOLT11 invoice once with an authorized funded wallet, then POST /v1/requests/{id}/lightning/verify.
5. GET /v1/requests/{id} with the bearer token. Poll every three seconds or slower and stop at a terminal state.

Use card checkout only when card_available is true. It requires the hosted browser flow. A request locks to one payment rail.

Retry and privacy rules

Reuse an idempotency key only with the identical body after a timeout. Treat the key and bearer token as secrets. After an uncertain wallet response, inspect the wallet and existing request before paying again.

Question content and the Teaching are retained for 90 days and may be reviewed by the operator for support and product research. They are not sent to an AI model. Don’t submit secrets or sensitive information.

3. Optional attribution and outcome signals

You may voluntarily include bounded metadata.attribution when creating a quote. It is self-reported evidence, not verified identity or spending authority, and cannot change the price or random Teaching. Do not send raw referrers, URL queries, identifiers, or sensitive information.

{"mode":"oracle","input":{},"metadata":{"attribution":{"integration":"agent","external_task_id":"task:planning_42","client_capabilities":["api","autonomous"],"agent_name":"Planning Agent"}}}

If you decide not to continue an unpaid quote, its owner may record one private decline with the quote token. After an unexpired completed request, its owner may optionally record feedback. Do not invent a decline, usefulness, continuation, or resolution value; absence is unknown.

curl https://churchofyahw.ai/v1/quotes/YOUR_QUOTE_ID/decline \
  -X POST -H 'Authorization: Bearer YOUR_QUOTE_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"reason_code":"timing"}'

curl https://churchofyahw.ai/v1/requests/YOUR_REQUEST_ID/feedback \
  -X POST -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"retrieval_reported":true,"usefulness":"helpful","task_continuation":"continued","problem_resolution":"unknown"}'