Skip to content

chore: Sync account schemas - #1057

Closed
lightspark-copybara[bot] wants to merge 1 commit into
mainfrom
auto/sync-grid-schemas-20260923-052502
Closed

lightspark-copybara[bot] wants to merge 1 commit into
mainfrom
auto/sync-grid-schemas-20260923-052502

Conversation

@lightspark-copybara

Copy link
Copy Markdown
Contributor

Auto-synced account schemas.

These schemas are generated from VASP adapter field definitions in sparkcore.

Synced schemas:

  • common/ — per-currency account info, beneficiary, and payment account schemas
  • common/PaymentInstructions.yaml — payment instructions oneOf (new currencies added)
  • external_accounts/ — per-currency external account schemas (reference common/)
  • mintlify/snippets/corridor-required-fields.mdx — per-corridor required fields table
  • mintlify/corridor-fields.js — filter script for that table

Please review the changes before merging.

@mintlify

mintlify Bot commented Sep 23, 2026 •

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated
Grid 🟢 Ready View Preview Sep 23, 2026, 5:26 AM

@vercel

vercel Bot commented Sep 23, 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 Sep 23, 2026 5:25am UTC
grid-flow-builder Ignored Ignored Preview Sep 23, 2026 5:25am UTC
grid-wallet-demo Ignored Ignored Preview Sep 23, 2026 5:25am UTC

Request Review

@github-actions

github-actions Bot commented Sep 23, 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

fix(types): make bank_account_type optional in UsdExternalAccountCreateInfo

kotlin

fix(types): make bankAccountType optional in UsdExternalAccountCreateInfo

openapi

fix(types): make bankAccountType optional in UsdExternalAccountCreateInfo

php

fix(types): make bankAccountType optional in UsdExternalAccountCreateInfo

python

fix(types): make bank_account_type optional in UsdExternalAccountCreateInfo

ruby

fix(types): make bank_account_type optional in UsdExternalAccountCreateInfo

typescript

fix(types): make bankAccountType optional in USD external account creation

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-cli 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-kotlin studio · code · diff

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

✅ 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-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@06e77a4b843a8d918ec368f8b0f682bb0afc25c9
✅ 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 ⏭️


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-23 05:29:29 UTC

@greptile-apps

greptile-apps Bot commented Sep 23, 2026 •

Copy link
Copy Markdown
Contributor

RetriggerConfidence Score: 4/5

The PR is not safe to merge until USD external-account creation requires bankAccountType again.

Findings

  1. P1 Required account type removed ▶
  2. P2 Legacy absence guidance removed ▶
Fix with agent prompt
### Issue 1
openapi/components/schemas/external_accounts/UsdExternalAccountCreateInfo.yaml:6-7
Moving `bankAccountType` into the optional shared base removes it from this create schema's required fields. All three USD external-account creation operations now allow clients to omit it, even though Grid uses the value to select the ACH transaction code. A savings account submitted without it can be treated as checking and cause the receiving bank to issue a notification of change.

```suggestion
  required:
  - bankAccountType
  - beneficiary
```

### Issue 2
openapi/components/schemas/common/UsdAccountInfo.yaml:15
Moving this response field into the shared base removes the explanation that `bankAccountType` can be absent from accounts created before the field became required. The property remains optional, but integrations no longer receive the compatibility guidance and may misdiagnose valid legacy responses.

---

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

Summary

This PR moves the USD bankAccountType property into the shared account base and regenerates both bundled OpenAPI documents. The consolidation introduces a contract regression:

  • USD external-account creation no longer requires bankAccountType.
  • Read schemas lose the legacy-account omission guidance that previously explained the field's optionality.

Reviews (1) · Last reviewed commit: "chore: Sync account schemas"

Comment on lines 6 to 7
required:
- bankAccountType
- beneficiary

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 Required account type removed

Moving bankAccountType into the optional shared base removes it from this create schema's required fields. All three USD external-account creation operations now allow clients to omit it, even though Grid uses the value to select the ACH transaction code. A savings account submitted without it can be treated as checking and cause the receiving bank to issue a notification of change.

Suggested change
required:
- bankAccountType
- beneficiary
required:
- bankAccountType
- beneficiary

Knowledge Base Used: Grid API contract

Prompt To Fix With AI
This is a comment left during a code review.
Path: openapi/components/schemas/external_accounts/UsdExternalAccountCreateInfo.yaml
Line: 6-7

Comment:
**Required account type removed**

Moving `bankAccountType` into the optional shared base removes it from this create schema's required fields. All three USD external-account creation operations now allow clients to omit it, even though Grid uses the value to select the ACH transaction code. A savings account submitted without it can be treated as checking and cause the receiving bank to issue a notification of change.

```suggestion
  required:
  - bankAccountType
  - beneficiary
```

**Knowledge Base Used:** [Grid API contract](https://app.greptile.com/lightspark/-/custom-context/knowledge-base/lightsparkdev/grid-api/-/docs/api-contract.md)

---

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

@@ -13,13 +13,3 @@ allOf:
- WIRE
- RTP
- FEDNOW

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.

P2 Legacy absence guidance removed

Moving this response field into the shared base removes the explanation that bankAccountType can be absent from accounts created before the field became required. The property remains optional, but integrations no longer receive the compatibility guidance and may misdiagnose valid legacy responses.

Knowledge Base Used: Grid API contract

Prompt To Fix With AI
This is a comment left during a code review.
Path: openapi/components/schemas/common/UsdAccountInfo.yaml
Line: 15

Comment:
**Legacy absence guidance removed**

Moving this response field into the shared base removes the explanation that `bankAccountType` can be absent from accounts created before the field became required. The property remains optional, but integrations no longer receive the compatibility guidance and may misdiagnose valid legacy responses.

**Knowledge Base Used:** [Grid API contract](https://app.greptile.com/lightspark/-/custom-context/knowledge-base/lightsparkdev/grid-api/-/docs/api-contract.md)

---

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

@lightspark-copybara

Copy link
Copy Markdown
Contributor Author

Superseded by #1072

@lightspark-copybara
lightspark-copybara Bot deleted the auto/sync-grid-schemas-20260923-052502 branch September 24, 2026 00:58

This branch was successfully deployed

1 active deployment
staging - mintlify — dace4dae Deployed Sep 23, 2026 by mintlify[bot]
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