{"openapi":"3.1.0","info":{"title":"Pakana Agent Onboarding API","version":"0.1.0"},"components":{"securitySchemes":{"onboardingCapability":{"type":"http","scheme":"bearer"}}},"paths":{"/healthz":{"get":{"responses":{"200":{"description":"health ok"}}}},"/readyz":{"get":{"responses":{"200":{"description":"all required dependencies ready"},"503":{"description":"one or more required dependencies unavailable"}}}},"/v1/readiness":{"get":{"responses":{"200":{"description":"public lane release is ready"},"503":{"description":"public lane release has readiness blockers"}}}},"/v1/packages":{"get":{"responses":{"200":{"description":"package list"}}}},"/v1/agent-cards":{"post":{"responses":{"201":{"description":"signed public AgentCard stored under an immutable content-addressed URL"},"400":{"description":"invalid, unsigned, or expired AgentCard"},"413":{"description":"AgentCard exceeds the public size limit"}}}},"/v1/agent-cards/{documentDigest}":{"get":{"responses":{"200":{"description":"immutable signed public AgentCard envelope"},"404":{"description":"unknown or expired AgentCard"}}}},"/v1/agent-certifications/credentials":{"post":{"responses":{"200":{"description":"idempotent Ed25519 agent-control credential and signed complete revocation-status snapshot issued after Primary-observed replica evidence matches the hosted AgentCard"},"400":{"description":"AgentCard or replica binding mismatch"},"409":{"description":"certification is not yet Primary-observed"},"503":{"description":"agent-control issuance is disabled"}}}},"/v1/checkout/sessions":{"post":{"responses":{"201":{"description":"checkout created"}}}},"/v1/starter-pack/provisioning-intents":{"post":{"responses":{"201":{"description":"nonce-bound provisioning challenge created for an agent-owned beneficiary account"}}}},"/v1/starter-pack/provisioning-intents/{id}/confirm":{"post":{"responses":{"200":{"description":"agent and beneficiary control proofs verified for provisioning; beneficiary proof may be raw Ed25519 or an explicit Freighter signed-message proof"},"409":{"description":"provisioning intent expired or consumed"}}}},"/v1/starter-pack/provisioning-intents/{id}/agent-trustline":{"get":{"responses":{"201":{"description":"exact prepared LBX trustline transaction plus nonce-bound Agent Exchange callback payload"},"409":{"description":"provisioning or account bootstrap is not ready"}}},"post":{"responses":{"200":{"description":"agent-authorized, beneficiary-signed exact LBX trustline submitted for issuer authorization"},"400":{"description":"invalid or mismatched signed trustline transaction"}}}},"/v1/webhooks/stripe":{"post":{"responses":{"200":{"description":"webhook accepted"}}}},"/v1/checkout/usdc":{"post":{"responses":{"201":{"description":"autonomous USDC checkout created; returns x402-style payment requirements (USDC amount, treasury address, memo challenge)"},"503":{"description":"autonomous USDC checkout is not configured"}}}},"/v1/checkout/usdc/fulfill":{"post":{"responses":{"200":{"description":"on-chain USDC settlement verified via Horizon; checkout marked paid and access code issued"},"400":{"description":"settlement verification failed"}}}},"/v1/redemption/challenges":{"post":{"security":[{"onboardingCapability":[]}],"responses":{"201":{"description":"challenge created"}}}},"/v1/starter-pack/redemption-challenges":{"post":{"security":[{"onboardingCapability":[]}],"responses":{"201":{"description":"Starter Pack redemption challenge created"}}}},"/v1/starter-pack/redemptions":{"post":{"security":[{"onboardingCapability":[]}],"responses":{"202":{"description":"Starter Pack code reserved for Treasury fulfillment"},"409":{"description":"Starter Pack code is unavailable"}}}},"/v1/starter-pack/redemptions/{id}":{"get":{"security":[{"onboardingCapability":[]}],"responses":{"200":{"description":"Starter Pack status, public transaction hashes, and signed completion credential when issued"},"401":{"description":"invalid onboarding capability"},"404":{"description":"unknown redemption"}}}},"/v1/entitlements/redeem":{"post":{"security":[{"onboardingCapability":[]}],"responses":{"200":{"description":"entitlement redeemed"}}}},"/v1/onboardings/{id}/redemption-code":{"get":{"security":[{"onboardingCapability":[]}],"responses":{"200":{"description":"verified-payment redemption code"},"409":{"description":"payment confirmation is pending or instant provisioning keeps the code internal"}}}},"/v1/onboardings/{id}":{"get":{"security":[{"onboardingCapability":[]}],"responses":{"200":{"description":"onboarding details"}}}},"/v1/onboardings/{id}/next-action":{"get":{"security":[{"onboardingCapability":[]}],"responses":{"200":{"description":"next action"}}}},"/v1/onboardings/{id}/workflow":{"get":{"security":[{"onboardingCapability":[]}],"responses":{"200":{"description":"concise user-facing certified resource workflow state and next action"},"404":{"description":"unknown onboarding"}}}},"/v1/onboardings/{id}/activate":{"post":{"security":[{"onboardingCapability":[]}],"responses":{"200":{"description":"sponsored account activated"}}}},"/v1/onboardings/{id}/transactions/{kind}":{"get":{"security":[{"onboardingCapability":[]}],"responses":{"201":{"description":"prepared tx"}}}},"/v1/onboardings/{id}/transactions/{kind}/signed":{"post":{"security":[{"onboardingCapability":[]}],"responses":{"200":{"description":"submitted tx"}}}},"/v1/onboardings/{id}/trustline/authorize":{"post":{"security":[{"onboardingCapability":[]}],"responses":{"200":{"description":"LBX trustline authorized"}}}},"/v1/onboardings/{id}/readiness":{"get":{"security":[{"onboardingCapability":[]}],"responses":{"200":{"description":"x402 readiness"}}}},"/v1/onboardings/{id}/readiness/verify":{"post":{"security":[{"onboardingCapability":[]}],"responses":{"200":{"description":"paid x402 readiness verified"}}}}}}