Skip to content

docs: declare the 429 daily-volume response on /sandbox/send - #866

Draft
ls-bolt[bot] wants to merge 1 commit into
mainfrom
08-25-sandbox-send-429-daily-volume
Draft

docs: declare the 429 daily-volume response on /sandbox/send#866
ls-bolt[bot] wants to merge 1 commit into
mainfrom
08-25-sandbox-send-429-daily-volume

Conversation

@ls-bolt

@ls-bolt ls-bolt Bot commented Aug 25, 2026

Copy link
Copy Markdown
Contributor

Summary

/sandbox/send can refuse a request with DAILY_VOLUME_LIMIT_EXCEEDED when funding a quote would take the customer past the daily withdrawal limit, but its response list did not declare a 429. Generated clients therefore had no typed error for a status the endpoint really returns.

  • Declare the 429 / Error429 response on /sandbox/send.
  • Widen the /quotes 429 description: the daily limit is checked when a quote is created, not only when immediatelyExecute is set.

Edited in openapi/ (the source) and rebundled with make build, so the generated openapi.yaml and mintlify/openapi.yaml stay in sync.

No enum changes — Error429 already carries DAILY_VOLUME_LIMIT_EXCEEDED, and Error400 already carries TRANSACTION_SIZE_LIMIT_EXCEEDED. This only documents the responses on the endpoints that emit them, so /transfer-out, /quotes, /quotes/{quoteId}/execute, and /sandbox/send now all declare the 429.

Compatibility

Additive. A newly documented error response on an endpoint that already returns it — no request or success-response shape changes, and no existing field is removed or renamed.

Test plan

  • npm run build:openapi re-run; git diff --exit-code openapi.yaml mintlify/openapi.yaml is clean, which is the check CI runs
  • npx spectral lint openapi.yaml --fail-severity=error — passes (exit 0)
  • npx @redocly/cli lint openapi/openapi.yaml — 7 errors, all pre-existing in the card-simulation paths; identical count on a clean main
  • Verified all four endpoints that can emit the limit now declare 429 with the Error429 schema
@vercel

vercel Bot commented Aug 25, 2026

Copy link
Copy Markdown

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

2 Skipped Deployments
Project Deployment Actions Updated (UTC)
grid-flow-builder Ignored Ignored Preview Aug 25, 2026 11:57pm
grid-wallet-demo Ignored Ignored Preview Aug 25, 2026 11:57pm

Request Review

@ls-bolt ls-bolt Bot added the bolt label Aug 25, 2026

Copy link
Copy Markdown

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

@github-actions

github-actions Bot commented Aug 25, 2026

Copy link
Copy Markdown
Contributor

✱ 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

chore(internal): regenerate SDK with no functional changes

kotlin

chore(internal): regenerate SDK with no functional changes

openapi

feat(api): add 429 error response to quote funding method

php

chore(internal): regenerate SDK with no functional changes

python

chore(internal): regenerate SDK with no functional changes

ruby

chore(internal): regenerate SDK with no functional changes

typescript

chore(internal): regenerate SDK with no functional changes

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 "warning" diagnostic, but this did not represent a regression.
generate ⚠️build ⏭️ (prev: build ✅) → lint ⏭️ (prev: lint ❗) → test ✅

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 "warning" diagnostic, but this did not represent a regression.
generate ⚠️build ⏭️ (prev: build ✅) → lint ✅test ✅

grid-go studio · code · diff

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

go get github.com/stainless-sdks/grid-go@91ab1d69fbe33549f6f11a7a693caab048394470
grid-kotlin studio · code · diff

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

grid-python studio · code · diff

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

grid-php studio · code · diff

Your SDK build had at least one "warning" 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-26 00:05:20 UTC

/sandbox/send can refuse with DAILY_VOLUME_LIMIT_EXCEEDED when funding a
quote would take the customer past the daily withdrawal limit, but its
response list did not document a 429, so generated clients had no typed
error for it.

Also widen the /quotes 429 description: the limit is checked when a quote
is created, not only when immediatelyExecute is set.

Co-Authored-By: jacklatourette <jacklatourette@users.noreply.github.com>
@ls-bolt
ls-bolt Bot force-pushed the 08-25-sandbox-send-429-daily-volume branch from b1a602c to c378f97 Compare August 26, 2026 00:00
@mintlify

mintlify Bot commented Aug 26, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
Grid 🟢 Ready View Preview Aug 26, 2026, 12:02 AM
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

2 participants