{"openapi":"3.1.0","info":{"title":"Guru Deva — Guru API","version":"2026-09-07","description":"Metered usage with prepaid credits and explicit spending caps. Payment credentials, account tokens and consultation content never belong in URLs.","termsOfService":"https://guru.devic.agency/terms"},"servers":[{"url":"https://guru.devic.agency"}],"x-service-info":{"name":"Guru Deva","description":"Guru philosophical consultations","docsUrl":"https://guru.devic.agency/developers"},"components":{"securitySchemes":{"clerkSession":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Short-lived owner session token managed by Clerk. Obtain through normal website sign-in; never copy reusable account keys."},"clerkOAuth":{"type":"http","scheme":"bearer","description":"Clerk OAuth access token with guru:use scope for this agent's sessions. Discover authorization at https://guru.devic.agency/.well-known/oauth-protected-resource/mcp. This is not an owner credential."},"accountKey":{"type":"http","scheme":"bearer","description":"Opaque account key returned once by POST /api/accounts"},"jobToken":{"type":"http","scheme":"bearer","description":"One consultation's job token"},"agentGrant":{"type":"http","scheme":"bearer","description":"Opaque grant returned once after owner-confirmed pairing; limited to its session and aggregate spend scope"},"pendingPairing":{"type":"http","scheme":"bearer","description":"Short-lived pending handle returned by code redemption and consumed by one confirmed exchange"}}},"paths":{"/api/services":{"get":{"operationId":"discoverGuru","summary":"Free catalog, availability, rate card and supported payment rails","responses":{"200":{"description":"Catalog","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/accounts":{"post":{"operationId":"createAccount","summary":"Create an account; save the returned credential securely","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Missing or invalid account credential","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment or credit required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Replay conflict or unresolved payment; do not charge again","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"503":{"description":"Preview or unavailable","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/account":{"get":{"operationId":"getBalance","summary":"Available balance, reserved amount and content-free ledger","security":[{"accountKey":[]},{"clerkSession":[]}],"responses":{"200":{"description":"Account","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/quote":{"post":{"operationId":"estimateUsage","summary":"Estimate a hypothetical usage breakdown; no charge or reservation","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["inputTokens","outputTokens","retrievalQueries"],"properties":{"inputTokens":{"type":"integer","minimum":0,"maximum":2000000},"outputTokens":{"type":"integer","minimum":0,"maximum":200000},"retrievalQueries":{"type":"integer","minimum":0,"maximum":100},"cachedInputTokens":{"type":"integer","minimum":0},"embeddingUnits":{"type":"integer","minimum":0}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Missing or invalid account credential","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment or credit required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Replay conflict or unresolved payment; do not charge again","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"503":{"description":"Preview or unavailable","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/topups":{"post":{"operationId":"prepareTopup","summary":"Prepare prepaid usage credit; choose exactly one payment rail","security":[{"accountKey":[]},{"clerkSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["amountCents"],"properties":{"amountCents":{"type":"integer","minimum":100,"maximum":50000}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Missing or invalid account credential","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment or credit required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Replay conflict or unresolved payment; do not charge again","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"503":{"description":"Preview or unavailable","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/topups/{id}":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"get":{"operationId":"getTopup","summary":"Free authenticated payment status and receipt","security":[{"accountKey":[]},{"clerkSession":[]}],"responses":{"200":{"description":"Payment status","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/topups/{id}/checkout":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"post":{"operationId":"createCardCheckout","summary":"Return a hosted Stripe URL for human card approval","security":[{"accountKey":[]},{"clerkSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Missing or invalid account credential","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment or credit required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Replay conflict or unresolved payment; do not charge again","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"503":{"description":"Preview or unavailable","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/topups/{id}/x402":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"post":{"operationId":"payTopupX402","summary":"Buy an exact top-up using x402 v2 USDC; same top-up credits once","security":[{"accountKey":[]},{"clerkSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Missing or invalid account credential","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment or credit required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Replay conflict or unresolved payment; do not charge again","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"503":{"description":"Preview or unavailable","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}},"description":"Account bearer + PAYMENT-SIGNATURE. A 402 PAYMENT-REQUIRED header supplies authoritative terms. Query status after ambiguity; never pay the same top-up through another rail."}},"/api/topups/{id}/mpp":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"post":{"operationId":"payTopupMPP","summary":"Buy an exact top-up using MPP Stripe SPT","security":[{"accountKey":[]},{"clerkSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Missing or invalid account credential","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment or credit required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Replay conflict or unresolved payment; do not charge again","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"503":{"description":"Preview or unavailable","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}},"description":"Authorization: Bearer stays for account access; payment uses Payment-Authorization. Runtime 402 challenges contain authoritative terms. No consultation content in payment payloads.","x-payment-info":{"offers":[]}}},"/api/sessions":{"post":{"operationId":"createGuruSession","summary":"Create or recover an Individualization, Meditation or Conversation session","security":[{"accountKey":[]},{"clerkSession":[]},{"agentGrant":[]},{"clerkOAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["offering"],"properties":{"offering":{"type":"string","enum":["individualization","meditation","conversation","governance-review","proposal-review","dialogue"]},"maxCostUsd6":{"type":"integer","minimum":10000,"maximum":100000000},"contextTokenLimit":{"type":"integer","minimum":128,"maximum":131072},"sessionKey":{"type":"string","pattern":"^[a-zA-Z0-9_-]{16,128}$"},"privateSession":{"type":"boolean","default":false},"together":{"type":"boolean","description":"Meditation only: the agent's human meditates too. Open-ended, metered per turn, no default context allowance."}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Missing or invalid account credential","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment or credit required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Replay conflict or unresolved payment; do not charge again","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"503":{"description":"Preview or unavailable","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9_-]{16,128}$"}}]}},"/api/sessions/{id}":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"get":{"operationId":"getGuruSession","summary":"Read exact boundary messages, state and aggregate billing","security":[{"accountKey":[]},{"clerkSession":[]},{"agentGrant":[]},{"clerkOAuth":[]}],"responses":{"200":{"description":"Session","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Session not found or outside grant scope","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/sessions/{id}/turns":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"post":{"operationId":"createGuruTurn","summary":"Reserve funded prepaid credit under the internal per-turn ceiling; existing explicit limits remain enforced","security":[{"accountKey":[]},{"clerkSession":[]},{"agentGrant":[]},{"clerkOAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["brief"],"properties":{"brief":{"type":"string","minLength":1,"maxLength":32768},"context":{"type":"string","maxLength":32768},"human":{"type":"string","minLength":1,"maxLength":32768,"description":"Together Meditation only: the human's exact words this turn, relayed verbatim."},"phase":{"type":"string","enum":["discovery","draft","revision","dialogue","intake","review","followup"]},"publicResearchSubject":{"type":"string","minLength":2,"maxLength":300,"description":"Solon review packages only: public DAO/system/proposal identifier approved for the public-search service. Never private draft text or credentials; retained within the project's content lifetime."},"proceedWithAvailableEvidence":{"type":"boolean","description":"Solon review packages only: request the review with explicitly stated evidence limits, without another charge."},"maxCostUsd6":{"type":"integer","minimum":10000,"maximum":100000000,"description":"Optional ceiling for this turn. It cannot expand available credit or an existing explicit session/grant limit."},"maxResponseTokens":{"type":"integer","minimum":128,"maximum":8192}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Missing or invalid account credential","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment or credit required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Replay conflict or unresolved payment; do not charge again","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"503":{"description":"Preview or unavailable","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9_-]{16,128}$"}}]}},"/api/sessions/{id}/state":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"post":{"operationId":"controlGuruSession","summary":"Pause, resume or end a session without creating paid work","security":[{"accountKey":[]},{"clerkSession":[]},{"agentGrant":[]},{"clerkOAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["action"],"properties":{"action":{"type":"string","enum":["pause","resume","end"]}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Missing or invalid account credential","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment or credit required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Replay conflict or unresolved payment; do not charge again","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"503":{"description":"Preview or unavailable","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/sessions/{id}/report":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"post":{"operationId":"finalizeSolonReviewPdf","summary":"Render the exact stored Solon review and close its project; use the included follow-up first","security":[{"accountKey":[]},{"clerkSession":[]},{"agentGrant":[]},{"clerkOAuth":[]}],"responses":{"200":{"description":"Final report PDF; project is closed","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Outside ownership/grant scope","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"No completed review, in-flight work, stale report or project already closed; retry reads safely","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"410":{"description":"Report retention expired","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}},"get":{"operationId":"downloadSolonReviewPdf","summary":"Free authenticated re-download of a closed project's stored report","security":[{"accountKey":[]},{"clerkSession":[]},{"agentGrant":[]},{"clerkOAuth":[]}],"responses":{"200":{"description":"Stored report PDF","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Outside ownership/grant scope","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Close the project with POST first","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"410":{"description":"Report retention expired","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/sessions/{id}/transcript":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","markdown"]}}],"get":{"operationId":"downloadGuruTranscript","summary":"Free exact captured boundary transcript","security":[{"accountKey":[]},{"clerkSession":[]},{"agentGrant":[]},{"clerkOAuth":[]}],"responses":{"200":{"description":"Transcript","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/pairings":{"post":{"operationId":"createGuruPairing","summary":"Owner creates a ten-minute one-time code for one agent","security":[{"accountKey":[]},{"clerkSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["maxCostUsd6"],"properties":{"sessionId":{"type":"string","pattern":"^gsess_"},"maxCostUsd6":{"type":"integer","minimum":10000,"maximum":100000000}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Missing or invalid account credential","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment or credit required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Replay conflict or unresolved payment; do not charge again","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"503":{"description":"Preview or unavailable","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/pairings/redeem":{"post":{"operationId":"redeemGuruPairing","summary":"Agent redeems a one-use code for a pending handle","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","pattern":"^[A-Z2-9]{4}-[A-Z2-9]{4}$"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Missing or invalid account credential","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment or credit required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Replay conflict or unresolved payment; do not charge again","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"503":{"description":"Preview or unavailable","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/pairings/redeem/status":{"get":{"operationId":"getPendingPairingStatus","summary":"Agent checks whether the owner confirmed the pending pairing","security":[{"pendingPairing":[]}],"responses":{"200":{"description":"Pairing status","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/pairings/redeem/exchange":{"post":{"operationId":"exchangeConfirmedPairing","summary":"Consume a confirmed pending handle and return one scoped agent grant","security":[{"pendingPairing":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Missing or invalid account credential","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment or credit required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Replay conflict or unresolved payment; do not charge again","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"503":{"description":"Preview or unavailable","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/pairings/{id}/confirm":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"post":{"operationId":"confirmGuruPairing","summary":"Owner confirms the pairing ID before grant exchange","security":[{"accountKey":[]},{"clerkSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Missing or invalid account credential","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment or credit required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Replay conflict or unresolved payment; do not charge again","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"503":{"description":"Preview or unavailable","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/pairings/{id}/revoke":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"post":{"operationId":"revokeGuruPairing","summary":"Owner revokes the active grant; already-claimed work may still finalize","security":[{"accountKey":[]},{"clerkSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Missing or invalid account credential","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment or credit required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Replay conflict or unresolved payment; do not charge again","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"503":{"description":"Preview or unavailable","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/individualization/purchases/{id}":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"get":{"operationId":"getIndividualizationPurchase","summary":"Read flat-package settlement, expiry and refund state","security":[{"accountKey":[]},{"clerkSession":[]}],"responses":{"200":{"description":"Purchase","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/individualization/purchases/{id}/balance":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"post":{"operationId":"buyIndividualizationFromBalance","summary":"Buy one flat workshop package from available account credit; retries do not debit twice","security":[{"accountKey":[]},{"clerkSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Missing or invalid account credential","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment or credit required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Replay conflict or unresolved payment; do not charge again","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"503":{"description":"Preview or unavailable","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/individualization/purchases/{id}/checkout":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"post":{"operationId":"createIndividualizationCheckout","summary":"Recover or create the stable Stripe-hosted flat-package checkout","security":[{"accountKey":[]},{"clerkSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Missing or invalid account credential","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment or credit required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Replay conflict or unresolved payment; do not charge again","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"503":{"description":"Preview or unavailable","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/individualization/purchases/{id}/x402":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"post":{"operationId":"payIndividualizationX402","summary":"Settle the exact flat package through x402; never credits usage balance","security":[{"accountKey":[]},{"clerkSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Missing or invalid account credential","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment or credit required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Replay conflict or unresolved payment; do not charge again","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"503":{"description":"Preview or unavailable","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/individualization/purchases/{id}/mpp":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"post":{"operationId":"payIndividualizationMPP","summary":"Settle the exact flat package through MPP Stripe SPT","security":[{"accountKey":[]},{"clerkSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Missing or invalid account credential","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment or credit required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Replay conflict or unresolved payment; do not charge again","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"503":{"description":"Preview or unavailable","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/individualization/purchases/{id}/refund":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"post":{"operationId":"requestUnfulfilledIndividualizationRefund","summary":"Freeze an unfulfilled package and record a refund request for operator review","security":[{"accountKey":[]},{"clerkSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Missing or invalid account credential","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment or credit required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Replay conflict or unresolved payment; do not charge again","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"503":{"description":"Preview or unavailable","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}}},"x-guru-rate-card":{"version":"guru-sonnet-5-low-2026-09-23-v1-1.5x","model":"claude-sonnet-5","effort":"low","currency":"USD","inputPerMillion":2,"cachedInputPerMillion":0.2,"cacheWrite5mPerMillion":2.5,"cacheWrite1hPerMillion":4,"outputPerMillion":10,"embeddingPerMillion":0,"embeddingUnit":"included-in-retrieval","retrievalSku":"vertex-rag-composite-query-standard-search","retrievalPerQuery":0.0015,"rankingPerQuery":0.001,"webGroundingPerQuery":0.014,"infrastructurePerConsult":0.01,"multiplier":1.5,"provisional":false,"effectiveFrom":"2026-09-23T10:00:00Z","validUntil":"2026-12-22T10:00:00Z","pricingSource":"https://platform.claude.com/docs/en/about-claude/pricing","vertexPricingSource":"https://cloud.google.com/generative-ai-app-builder/pricing"}}