feat(webhooks): add wallet-operation partner webhook

[carsonp6]

What

Add the wallet-operation partner webhook to the public Grid API spec: the webhook entry plus its WalletOperationWebhook / WalletOperationWebhookData / OperationError schemas, and the two WALLET_OPERATION.* values in the central WebhookType enum.

This documents a webhook that already fires from the backend on terminal transitions of asynchronous embedded-wallet operations — WALLET_OPERATION.COMPLETED on terminal success, WALLET_OPERATION.FAILED on terminal failure. We are just formalizing the public contract.

Shape

• Webhook envelope type (UPPERCASE, matching the OBJECT.EVENT convention): WALLET_OPERATION.COMPLETED, WALLET_OPERATION.FAILED.
• data.status (lowercase): completed, failed.
• data.operationType (the specific op): auth_credential.delete, session.revoke, wallet.export.
• data.error ({ code }) present only on failure; null/omitted otherwise.
• The webhook carries no sensitive result material. For a data-returning op (wallet.export), the result is never delivered in the webhook — it is retrieved by resubmitting the original signed export request until it returns the result.

Notes

• Additive / non-breaking — no info.version bump (stays 2025-10-13); no servers.url change.
• Regenerated bundles (openapi.yaml, mintlify/openapi.yaml) via npm run build:openapi; npm run lint:openapi passes with 0 errors.
• Replaces the webhook portion of the older draft [grid-api] async-ops: GET /operations + wallet_operation webhooks (DRAFT — do not merge until async feature deploys) #559. This PR is intentionally webhook-only and drops the GET /operations/{operationId} poll endpoint, per the resubmit-until-terminal retrieval contract that superseded poll-an-id. [grid-api] async-ops: GET /operations + wallet_operation webhooks (DRAFT — do not merge until async feature deploys) #559 will be closed in favor of this.

Status

DRAFT — first of a two-step change; the monorepo regen + emitter casing alignment lands separately.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
Grid	🟢 Ready	View Preview	Aug 5, 2026, 9:34 PM

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

2 Skipped Deployments

Project	Deployment	Actions	Updated (UTC)
grid-flow-builder	Ignored		Aug 5, 2026 9:32pm
grid-wallet-demo	Ignored		Aug 5, 2026 9:32pm

[github-actions]

✱ Stainless preview builds for grid

This PR will update the grid SDKs with the following commit messages.

cli

chore(internal): regenerate SDK with no functional changes

go

feat(api): add wallet operation webhook event type

kotlin

feat(api): add walletOperation webhook event type

openapi

feat(api): add wallet operation completed/failed webhook

php

feat(api): add WalletOperationWebhookEvent to webhooks

python

feat(api): add WalletOperationWebhookEvent webhook type

ruby

feat(api): add WalletOperationWebhookEvent to webhooks

typescript

feat(api): add WalletOperationWebhookEvent to webhooks

Edit this comment to update them. They will appear in their respective SDK's changelogs.

✅ grid-typescript studio · code · diff

Your SDK build had at least one "note" diagnostic, but this did not represent a regression.
generate ✅ → build ✅ → lint ❗ → test ✅

npm install https://pkg.stainless.com/s/grid-typescript/fe24eb93c27c2e4d3e27a026abfa47b085f4a635/dist.tar.gz

✅ grid-openapi studio · code · diff

Your SDK build had at least one "warning" diagnostic, but this did not represent a regression.
generate ⚠️

✅ grid-ruby studio · code · diff

Your SDK build had at least one "note" diagnostic, but this did not represent a regression.
generate ✅ → build ✅ → lint ✅ → test ✅

✅ grid-go studio · code · diff

Your SDK build had at least one "note" diagnostic, but this did not represent a regression.
generate ✅ → build ✅ → lint ❗ → test ❗

go get github.com/stainless-sdks/grid-go@590d98faa18be0fbbbe0c28236993ee0d98b6ff4

✅ grid-kotlin studio · code · diff

Your SDK build had at least one "warning" diagnostic, but this did not represent a regression.
generate ⚠️ → build ✅ → lint ✅ → test ❗

✅ grid-python studio · code · diff

Your SDK build had at least one "note" diagnostic, but this did not represent a regression.
generate ✅ → build ✅ → lint ❗ → test ❗

pip install https://pkg.stainless.com/s/grid-python/7b6a0fb2607e0e03893c185189f2608ef4251581/grid-0.0.1-py3-none-any.whl

✅ grid-php studio · code · diff

Your SDK build had at least one "note" diagnostic, but this did not represent a regression.
generate ✅ → lint ✅ → test ✅

✅ grid-cli studio · code · diff

Your SDK build had at least one "warning" diagnostic, but this did not represent a regression.
generate ⚠️ → build ❗ → lint ❗ → test ❗

---

This comment is auto-generated by GitHub Actions and is automatically kept up to date as you push.
If you push custom code to the preview branch, re-run this workflow to update the comment.
Last updated: 2026-08-05 21:38:30 UTC