Skip to content

docs(cards): document maxSpendPerTransaction field - #855

Open
claude[bot] wants to merge 1 commit into
mainfrom
docs/sync-20260822
Open

docs(cards): document maxSpendPerTransaction field#855
claude[bot] wants to merge 1 commit into
mainfrom
docs/sync-20260822

Conversation

@claude

@claude claude Bot commented Aug 22, 2026

Copy link
Copy Markdown
Contributor

Summary

Syncs card documentation with the maxSpendPerTransaction field added in #818 (commit 3fb4289).

  • issuing-cards.mdx: Added maxSpendPerTransaction to the request table and example curl
  • freezing-and-closing.mdx: Updated intro to mention the field, added "Updating the per-transaction limit" section with curl example

The OpenAPI spec and API reference pages already include the field; this brings the guides in line.

Test plan

  • make lint passes
  • Verified field description matches the OpenAPI schema

🤖 Generated with Claude Code

Document the per-transaction spending limit field added to cards in
commit 3fb4289. The OpenAPI spec and API reference pages already
include the field; this syncs the guides.

Changes:
- issuing-cards.mdx: add maxSpendPerTransaction to request table and
  example curl
- freezing-and-closing.mdx: mention maxSpendPerTransaction in intro,
  add "Updating the per-transaction limit" section with curl example

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Aug 22, 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 22, 2026, 8:12 AM

@vercel

vercel Bot commented Aug 22, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
grid-flow-builder Building Building Preview Aug 22, 2026 8:10am
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
grid-wallet-demo Ignored Ignored Aug 22, 2026 8:10am

Request Review

@greptile-apps

greptile-apps Bot commented Aug 22, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

This PR adds maxSpendPerTransaction to the card-issuance and card-update guides.

  • Documents the optional limit in the card creation request and field table.
  • Adds instructions for setting, clearing, or preserving the limit when updating a card.
  • The update example currently applies signed-retry mechanics that conflict with the endpoint’s OpenAPI contract.

Confidence Score: 4/5

The PR should be corrected before merging because the new update guide directs developers through a challenge flow that the endpoint does not implement.

The create-card documentation matches the schema, but the update section requires a prior 202 response and signing headers even though the current PATCH contract uses platform authentication and returns 200 directly.

Files Needing Attention: mintlify/snippets/cards/freezing-and-closing.mdx

Important Files Changed

Filename Overview
mintlify/snippets/cards/freezing-and-closing.mdx Adds accurate limit-value semantics but incorrectly documents the update as a signed-retry operation.
mintlify/snippets/cards/issuing-cards.mdx Adds a valid creation example and field description consistent with the create-card OpenAPI schema.
Prompt To Fix All With AI
### Issue 1
mintlify/snippets/cards/freezing-and-closing.mdx:135-136
**Signed-retry flow contradicts PATCH contract**

When a developer follows this new limit-update example, the guide requires a prior `202` challenge plus `Grid-Wallet-Signature` and `Request-Id`, while the current `PATCH /cards/{id}` contract uses platform credentials and returns `200` directly. The developer therefore waits for a challenge and request ID that the endpoint never returns, preventing completion of the documented update flow.

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

Reviews (1): Last reviewed commit: "docs(cards): document maxSpendPerTransac..." | Re-trigger Greptile

Comment on lines +135 to +136
curl -X PATCH "$GRID_BASE_URL/cards/Card:019542f5-b3e7-1d02-0000-000000000010" \
-u "$GRID_CLIENT_ID:$GRID_CLIENT_SECRET" \

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Signed-retry flow contradicts PATCH contract

When a developer follows this new limit-update example, the guide requires a prior 202 challenge plus Grid-Wallet-Signature and Request-Id, while the current PATCH /cards/{id} contract uses platform credentials and returns 200 directly. The developer therefore waits for a challenge and request ID that the endpoint never returns, preventing completion of the documented update flow.

Knowledge Base Used: Mintlify Documentation Site

Prompt To Fix With AI
This is a comment left during a code review.
Path: mintlify/snippets/cards/freezing-and-closing.mdx
Line: 135-136

Comment:
**Signed-retry flow contradicts PATCH contract**

When a developer follows this new limit-update example, the guide requires a prior `202` challenge plus `Grid-Wallet-Signature` and `Request-Id`, while the current `PATCH /cards/{id}` contract uses platform credentials and returns `200` directly. The developer therefore waits for a challenge and request ID that the endpoint never returns, preventing completion of the documented update flow.

**Knowledge Base Used:** [Mintlify Documentation Site](https://app.greptile.com/lightspark/-/custom-context/knowledge-base/lightsparkdev/grid-api/-/docs/mintlify-docs-site.md)

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants