API reference
117 operations, generated from the OpenAPI document the API serves. Base URL https://api.keelson.finance.
System
Events
Mandates
- GET
/v1/mandatesList your mandates - POST
/v1/mandatesStore a passkey-signed mandate - GET
/v1/mandates/{id}Get a mandate - POST
/v1/mandates/{id}/holdHold a mandate's budget - POST
/v1/mandates/{id}/hold/authorizeAuthorize an approved hold - POST
/v1/mandates/{id}/holdsHold one cart of a multi-merchant mandate - POST
/v1/mandates/{id}/holds/{requestId}/authorizeAuthorize an approved cart hold - POST
/v1/mandates/{id}/revokeRevoke a mandate - POST
/v1/mandates/{id}/changesAsk the user to change a mandate - POST
/v1/mandates/{id}/checkCheck a cart against a mandate - POST
/v1/mandates/compileCompile a mandate from a shopping request - GET
/v1/anonymous-mandates/{mandateHash}Proof that a registered user signed a mandate - GET
/v1/user-set/roots/{root}A root of the registered-user tree
PayPal
Connections
- POST
/v1/connectionsAsk the user for a mandate - POST
/v1/connections/tokenPoll for the user's answer - GET
/v1/connections/{code}Read a request by its user code - POST
/v1/connections/{code}/denyDeny a request - POST
/v1/connections/{code}/matchPick the agent's number - GET
/v1/connections/requests/{id}Read your request's state - POST
/v1/connections/{code}/draftDraft the mandate that approves a request
Embed
- PUT
/v1/embed/originsSet the origins that may frame approvals - POST
/v1/connections/embedEmbed the approval of a request - POST
/v1/embed/sessionsOpen the embedded approval - GET
/v1/embed/requestRead the embedded request - POST
/v1/embed/denyDecline the embedded request - POST
/v1/embed/sign-in/optionsStart a passkey sign-in in the embedded approval - POST
/v1/embed/sign-inSign in with a passkey in the embedded approval - POST
/v1/embed/linksLink the embedded approval to a Keelson window - POST
/v1/embed/links/inspectRead a link in the Keelson window - POST
/v1/embed/links/confirmConfirm a link from the Keelson window - POST
/v1/embed/links/claimClaim a link's grant in the embedded approval - POST
/v1/embed/passkeys/optionsStart creating a passkey in the embedded approval - POST
/v1/embed/passkeysCreate a passkey in the embedded approval - POST
/v1/embed/draftDraft the mandate in the embedded approval - POST
/v1/embed/mandatesApprove the embedded request with a signed mandate
Agents
Alerts
- GET
/v1/push/keyRead the push key - POST
/v1/push/subscriptionsGet alerts on this browser - DELETE
/v1/push/subscriptionsStop alerts on this browser - POST
/v1/push/testSend a test notification - GET
/v1/alerts/emailRead your alert address - PUT
/v1/alerts/emailSet your alert address - DELETE
/v1/alerts/emailStop email alerts - POST
/v1/alerts/email/confirmConfirm an alert address - POST
/v1/alerts/unsubscribeUnsubscribe in one click - GET
/v1/alerts/emailsList the emails sent to you
TEE
Purchases
- GET
/v1/live-purchasesLive purchases - PUT
/v1/purchases/{id}/paypal-transactionRecord a live purchase's PayPal transaction - GET
/v1/purchases/{id}A purchase - GET
/v1/purchases/{id}/cardThe single-use card of a card purchase - GET
/v1/fx/reference/{base}Reference exchange rates - POST
/v1/purchases/{id}/chargebackCharge back a card purchase - GET
/v1/anonymous-purchases/{id}Proof that a purchase was within a mandate a registered user signed - GET
/v1/engine-proofs/{id}SP1 proof of a purchase's engine evaluation - POST
/v1/purchases/{id}/trackingRecord a purchase's shipment and its delivery
Evidence
- POST
/v1/evidenceStore sealed evidence - GET
/v1/evidence/{root}Read an evidence manifest - GET
/v1/evidence/{root}/items/{index}Disclose one evidence item - POST
/v1/observations/channel3Observe a product through Channel3 - GET
/v1/observations/channel3/{id}Read a Channel3 observation - POST
/v1/observations/web-factNotarize a product endpoint with TLSNotary
Timestamps
Alibis
Disputes
Passkeys
Operators
- POST
/v1/operatorsLink an ERC-8004 agent as an operator - GET
/v1/operators/by-address/{address}/registration.jsonRegistration file of an owner's agents - GET
/v1/operators/{chainId}/{agentId}/registration.jsonRegistration file of an agent - GET
/v1/operators/{chainId}/{agentId}/bondBond, reputation and validations of an agent - GET
/v1/operators/{agentId}/mandatesThe active mandates naming the operator - POST
/v1/operators/{agentId}/mandates/{mandateId}/runsAnnounce an agent run under a mandate - GET
/v1/operators/{agentId}/gradeTrust grade, premium and bond of an operator - GET
/v1/operators/{agentId}/grade/streamFollow an operator's trust grade - GET
/v1/operators/meThe operators the session's wallet owns - POST
/v1/operators/{agentId}/coverages/rowsA block of the operator's coverages, for AG Grid's server-side row model - GET
/v1/operators/{agentId}/coverages/dailyThe operator's coverages per day - POST
/v1/operators/{agentId}/grid-queryTurn a sentence into the coverage grid's state
Reputation
Validations
Bonds
Log
Merchants
- POST
/v1/merchants/payout-addressSet a merchant's payout address, gasless - GET
/v1/merchants/{merchantId}/settlementHow a merchant is paid when a dispute goes its way - PUT
/v1/merchants/{merchantId}/settlementChoose how a merchant is paid when a dispute goes its way - GET
/v1/merchants/meThe merchant signed in - GET
/v1/merchants/{merchantId}/disputesA merchant's disputes and their verdicts - GET
/v1/merchants/{merchantId}/ordersThe agent purchases at a merchant - GET
/v1/merchants/{merchantId}/evaluationsField-level evaluations of the agents that shopped at a merchant - POST
/v1/merchants/{merchantId}/assistantOne streamed model turn for the merchant console's agents