Rewrite maxSpendPerTransaction descriptions in plain language by AaryamanBhute · Pull Request #956 · lightsparkdev/grid-api

AaryamanBhute · 2026-09-11T22:11:50Z

Summary

Rewrites every maxSpendPerTransaction description in plain language. The old text
read like an internal spec — "card-specific cap", "the effective limit", "Grid enforces
the lower of the two values without replacing this configured value". The new text says
what the field does in the second-person voice the rest of the docs use, and spells out
"smallest unit of the currency" with a concrete example (cents for USD) so a reader does
not have to infer it.

No schema constraints, types, examples, or field names changed — description strings only.

Changes: 7 source files (+ 2 regenerated bundles)

openapi/components/schemas/cards/Card.yaml — the field on the card resource
openapi/components/schemas/cards/CardCreateRequest.yaml — POST /cards
openapi/components/schemas/cards/CardUpdateRequest.yaml — PATCH /cards/{id}
openapi/components/schemas/config/CardConfig.yaml — the platform-wide cap
openapi/paths/cards/cards_{id}.yaml — the bullet in the PATCH operation description
mintlify/snippets/cards/issuing-cards.mdx — the field table row
mintlify/snippets/cards/freezing-and-closing.mdx — the per-transaction limit section
openapi.yaml, mintlify/openapi.yaml — regenerated by make build

Facts preserved in every rewrite: the value is in the currency's smallest unit; null /
omitted means no limit; the lower of the card and platform values applies; the
supportsSpendLimits capability gate; and that it cannot be sent alongside
state: CLOSED. The "a transaction for exactly the effective limit is allowed" sentence
was dropped in a follow-up commit — it was the fiddliest part of the old text, and cutting
it removes the ambiguity rather than wording around it.

The sibling maxSpendPerDay and maxTransactionsPerDay descriptions were left alone —
the request named maxSpendPerTransaction. They can get the same treatment in a
follow-up if you want the whole limits family to read consistently.

Rebased onto main

main picked up #934, which renames fundingSources (array) → fundingSource (single
string) and rewrites prose in the same description blocks this PR touches — so the two
conflicted. Resolved by keeping main's singular fundingSource wording everywhere and
re-applying only the maxSpendPerTransaction rewrites on top. The conflicted bundles were
regenerated with make build rather than hand-merged.

Test plan

make build — bundles cleanly, and a second run after the rebase produces zero drift,
so the committed bundles match the sources
make lint — "Your API description is valid", 2 warnings / 14 ignored, identical to
the pre-change baseline on main (verified by stashing and re-running)
Verified mechanically that the bundle is unchanged from current origin/main once
description keys are stripped, so nothing but prose moved
Confirmed no plural fundingSources crept back in during the rebase; Detect breaking changes passes
CI green; Greptile 5/5 with no unresolved comments

Original PR: #950

vercel · 2026-09-11T22:11:56Z

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

2 Skipped Deployments

Project	Deployment	Actions	Updated
grid-flow-builder	Ignored	Preview	Sep 12, 2026 6:24am UTC
grid-wallet-demo	Ignored	Preview	Sep 12, 2026 6:24am UTC

lightspark-bot · 2026-09-11T22:12:21Z

Rewrite maxSpendPerTransaction descriptions in plain language #956 👈 (View in Graphite)
main

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

github-actions · 2026-09-11T22:12:40Z

✱ Stainless preview builds for grid

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

cli

docs(api): update max-spend-per-transaction parameter descriptions in card/config

go

docs(api): update maxSpendPerTransaction documentation in card and config

kotlin

docs(api): update maxSpendPerTransaction docs in cards and platform config

openapi

docs(api): clarify maxSpendPerTransaction descriptions across card models

php

docs(api): clarify maxSpendPerTransaction descriptions in cards and config

python

docs(api): clarify max_spend_per_transaction parameter descriptions

ruby

docs(api): clarify max_spend_per_transaction descriptions in card and platform_config models

typescript

docs(api): update maxSpendPerTransaction parameter descriptions in cards and config

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 "error" diagnostic, but this did not represent a regression.
generate ❗ → build ⏭️ → lint ⏭️ → test ⏭️

✅ grid-openapi studio · code · diff

Your SDK build had at least one "error" diagnostic, but this did not represent a regression.
generate ❗

✅ grid-ruby studio · code · diff

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

✅ grid-kotlin studio · code · diff

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

✅ grid-go studio · code · diff

Your SDK build had at least one "error" diagnostic, but this did not represent a regression.
generate ❗ → build ⏭️ → lint ⏭️ → test ⏭️
go get github.com/stainless-sdks/grid-go@6374d0c4b9797bcb534d917b16c92076181ffb3f

✅ grid-python studio · code · diff

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

✅ grid-php studio · code · diff

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

✅ grid-cli studio · code · diff

Your SDK build had at least one "error" 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-09-12 06:27:50 UTC

ls-bolt · 2026-09-12T01:47:00Z

📌 Bolt Status

2026-09-12 01:47:00 UTC — ⚡ Agent shimmering-avalanche-2(#2) started
2026-09-12 06:21:25 UTC — ⚡ Agent shimmering-avalanche-3(#3) started

Feedback

mintlify · 2026-09-12T01:47:56Z

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

Project	Status	Preview	Updated
Grid	🟢 Ready	View Preview	Sep 12, 2026, 6:25 AM

AaryamanBhute · 2026-09-12T06:21:20Z

@bolt fix merge conflicts

…Transaction Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Q2vqFy3cS8cukWkLdMwZTP

ls-bolt · 2026-09-12T06:29:29Z

⚡ Revision log — updated in place, latest first.

Revision 1

Rebased onto main to clear the merge conflicts. main picked up feat(cards): bind one funding source per card #934, which renames fundingSources (array) → fundingSource (single string) and rewrites the surrounding prose in the same description blocks this PR touches
Resolved by keeping main's singular fundingSource wording everywhere and re-applying only the maxSpendPerTransaction description rewrites on top, in CardCreateRequest.yaml and the issuing-cards.mdx field table
Regenerated openapi.yaml and mintlify/openapi.yaml rather than hand-merging the conflicted bundles; a follow-up make build produces zero drift, so they match the sources
Verified no plural fundingSources crept back in, the diff vs main is now only the description rewrites, and Detect breaking changes passes. make lint still matches the main baseline (2 warnings, 14 ignored)

ls-bolt Bot added the bolt label Sep 11, 2026

ls-bolt Bot mentioned this pull request Sep 11, 2026

Rewrite maxSpendPerTransaction descriptions in plain language #950

Closed

mintlify Bot deployed to staging - mintlify September 12, 2026 01:47 View deployment

DhruvPareek approved these changes Sep 12, 2026

View reviewed changes

carsonp6 approved these changes Sep 12, 2026

View reviewed changes

whoisglover mentioned this pull request Sep 12, 2026

docs(cards): trim the card contract before the customerId rename #932

Closed

AaryamanBhute and others added 2 commits September 12, 2026 06:23

Rewrite maxSpendPerTransaction descriptions in plain language

4e07709

Drop the exact-limit sentence and name the platform-level maxSpendPer…

3a6f822

…Transaction Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Q2vqFy3cS8cukWkLdMwZTP

ls-bolt Bot force-pushed the 09-11-simplify-max-spend-per-transaction-descriptions branch from 0a56042 to 3a6f822 Compare September 12, 2026 06:24

mintlify Bot deployed to staging - mintlify September 12, 2026 06:25 View deployment

Navigation Menu

Uh oh!

Rewrite maxSpendPerTransaction descriptions in plain language - #956

Rewrite maxSpendPerTransaction descriptions in plain language#956
AaryamanBhute wants to merge 2 commits into
mainfrom
09-11-simplify-max-spend-per-transaction-descriptions

AaryamanBhute commented Sep 11, 2026 •

edited by ls-bolt Bot

Loading

Uh oh!

vercel Bot commented Sep 11, 2026 •

edited

Loading

Uh oh!

lightspark-bot commented Sep 11, 2026

Uh oh!

github-actions Bot commented Sep 11, 2026 •

edited

Loading

Uh oh!

ls-bolt Bot commented Sep 12, 2026 •

edited

Loading

Uh oh!

mintlify Bot commented Sep 12, 2026 •

edited

Loading

Uh oh!

AaryamanBhute commented Sep 12, 2026

Uh oh!

ls-bolt Bot commented Sep 12, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Uh oh!

Conversation

AaryamanBhute commented Sep 11, 2026 • edited by ls-bolt Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Changes: 7 source files (+ 2 regenerated bundles)

Rebased onto main

Test plan

Uh oh!

vercel Bot commented Sep 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

lightspark-bot commented Sep 11, 2026

Uh oh!

github-actions Bot commented Sep 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✱ Stainless preview builds for grid

Uh oh!

ls-bolt Bot commented Sep 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

mintlify Bot commented Sep 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

AaryamanBhute commented Sep 12, 2026

Uh oh!

ls-bolt Bot commented Sep 12, 2026

Revision 1

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

AaryamanBhute commented Sep 11, 2026 •

edited by ls-bolt Bot

Loading

vercel Bot commented Sep 11, 2026 •

edited

Loading

github-actions Bot commented Sep 11, 2026 •

edited

Loading

ls-bolt Bot commented Sep 12, 2026 •

edited

Loading

mintlify Bot commented Sep 12, 2026 •

edited

Loading