Skip to content

docs: limit embedded-wallet OTP length and validity window - #1177

Merged
carsonp6 merged 1 commit into
mainfrom
docs/embedded-wallet-otp-limits
Oct 16, 2026
Merged

carsonp6 merged 1 commit into
mainfrom
docs/embedded-wallet-otp-limits

Conversation

@carsonp6

@carsonp6 carsonp6 commented Oct 14, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Narrows two EmbeddedWalletConfig fields to the values an OTP send can actually use:

  • otpLength: 4–12 becomes 6–9.
  • expirationSeconds: 1–86400 becomes 1–600.

A config outside these ranges could be saved, and then every OTP send for that platform failed. With the narrower ranges, PATCH /config rejects the value up front with a field error.

The ranges match the OTP provider's documented limits: a 6–9 character code, and a validity window of at most 600 seconds.

Changes

  • openapi/components/schemas/config/EmbeddedWalletConfig.yaml: the new min/max values.
  • openapi.yaml and mintlify/openapi.yaml: rebundled with make build.

make lint-openapi and spectral both pass.

Follow-up

The vendored client is regenerated in webdev on grid-otp-config-limits-regen. That PR lands after this one merges.

🤖 Generated with Claude Code

otpLength now accepts 6-9 and expirationSeconds accepts 1-600. Values
outside these ranges could be saved but failed every OTP send for the
platform. Rejecting them at the config update gives a clear field error
instead.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@vercel

vercel Bot commented Oct 14, 2026 •

Copy link
Copy Markdown

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

3 Skipped Deployments
Project Deployment Actions Updated
grid-cards-demo Ignored Ignored Preview Oct 14, 2026 4:31am UTC
grid-flow-builder Ignored Ignored Preview Oct 14, 2026 4:31am UTC
grid-wallet-demo Ignored Ignored Preview Oct 14, 2026 4:31am UTC

Request Review

@mintlify

mintlify Bot commented Oct 14, 2026 •

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated
Grid 🟢 Ready View Preview Oct 14, 2026, 4:32 AM

Copy link
Copy Markdown
Contributor Author

This stack of pull requests is managed by Graphite. Learn more about stacking.

@github-actions github-actions Bot added the breaking-change Introduces a breaking change to the OpenAPI spec label Oct 14, 2026
@github-actions

Copy link
Copy Markdown
Contributor

⚠️ Breaking OpenAPI changes detected

oasdiff reports 7 error / 0 warning changes to openapi.yaml.
This PR will need approval from an API reviewer before merge.

Errors (7)

  • PATCH /config — the embeddedWalletConfig/expirationSeconds request property's max was decreased to 600.00 [request-property-max-decreased].
  • PATCH /config — the embeddedWalletConfig/otpLength request property's max was decreased to 9.00 [request-property-max-decreased].
  • PATCH /config — the embeddedWalletConfig/otpLength request property's min was increased to 6.00 [request-property-min-increased].
  • POST webhook:agent-action — removed the enum value INCORRECT_CARD_DETAILS of the request property allOf[subschema #2]/data/transaction/allOf[#/components/schemas/TransactionOneOf]/oneOf[subschema #3: Card Transaction]/cardDeclinedReason [request-property-enum-value-removed].
  • POST webhook:agent-action — removed the enum value TEMPORARILY_UNAVAILABLE of the request property allOf[subschema #2]/data/transaction/allOf[#/components/schemas/TransactionOneOf]/oneOf[subschema #3: Card Transaction]/cardDeclinedReason [request-property-enum-value-removed].
  • POST webhook:card-transaction — removed the enum value INCORRECT_CARD_DETAILS of the request property allOf[subschema #2]/data/cardDeclinedReason [request-property-enum-value-removed].
  • POST webhook:card-transaction — removed the enum value TEMPORARILY_UNAVAILABLE of the request property allOf[subschema #2]/data/cardDeclinedReason [request-property-enum-value-removed].

Detected by oasdiff. Full report: job summary or the oasdiff-report artifact.

@greptile-apps

greptile-apps Bot commented Oct 16, 2026 •

Copy link
Copy Markdown
Contributor

RetriggerView in GreptileConfidence Score: 5/5

[Low impact] The PR appears safe to merge; no actionable issues were found.

Summary

Narrows EmbeddedWalletConfig limits and updates both generated OpenAPI bundles.

  • Embedded-wallet settings now limit OTP code size and validity.

Reviews (1) · Last reviewed commit: "docs: limit embedded-wallet OTP length a..." · Reviewed by Greptile

@carsonp6

Copy link
Copy Markdown
Contributor Author

Confirmed no platforms today hold values outside of this range.

@carsonp6
carsonp6 merged commit 1885b34 into main Oct 16, 2026
10 checks passed
@carsonp6
carsonp6 deleted the docs/embedded-wallet-otp-limits branch October 16, 2026 18:02

This branch was successfully deployed

1 active deployment
staging - mintlify — 9c98bc44 Deployed Oct 14, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

breaking-change Introduces a breaking change to the OpenAPI spec

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants