Conversation
✱ Stainless preview buildsThis PR will update the kotlin openapi python typescript Edit this comment to update them. They will appear in their respective SDK's changelogs. ✅ grid-openapi studio · code · diff
✅ grid-python studio · code · diff
✅ grid-kotlin studio · code · diff
✅ grid-typescript studio · code · diff
This comment is auto-generated by GitHub Actions and is automatically kept up to date as you push. |
780647d to
2032fbc
Compare
Greptile SummaryThis PR refactors the external account schema from a payment-method-based model (e.g. Key changes:
Issues found:
Confidence Score: 2/5
|
| Filename | Overview |
|---|---|
| openapi/components/schemas/external_accounts/ExternalAccountType.yaml | Replaced old payment-method-based types (US_ACCOUNT, CLABE, PIX, IBAN, UPI, NGN_ACCOUNT, CAD_ACCOUNT) with currency-based types (USD_ACCOUNT, BRL_ACCOUNT, DKK_ACCOUNT, etc.). The enum now consistently uses currency codes as identifiers. Example value updated to GBP_ACCOUNT. |
| openapi/components/schemas/external_accounts/ExternalAccountInfoOneOf.yaml | Updated oneOf list and discriminator mapping to match new currency-based account types. New account types (BRL, DKK, HKD, IDR, INR, MXN, MYR, PHP, SGD, THB, USD, VND) replace old payment-method-based schemas. Mapping is consistent with ExternalAccountType enum. |
| openapi/components/schemas/external_accounts/BaseExternalAccountInfo.yaml | Discriminator mapping updated to reference new currency-specific ExternalAccountInfo files. Mapping is consistent across ExternalAccountType, ExternalAccountInfoOneOf, and BaseExternalAccountInfo. |
| openapi/components/schemas/common/UsdAccountInfo.yaml | New USD account schema replacing US_ACCOUNT type. Missing accountCategory (CHECKING/SAVINGS) field that existed in UsAccountInfo, along with validation patterns and examples for accountNumber and routingNumber. This is a potential regression for API consumers. |
| openapi/components/schemas/common/IdrAccountInfo.yaml | IDR (Indonesian Rupiah) account schema uses a "sortCode" field. Sort codes are a UK banking concept and not used in Indonesia's banking system. This field name appears to be incorrect for IDR/Indonesia. |
| openapi/components/schemas/common/BrlAccountInfo.yaml | New BRL (Brazilian Real) account schema using PIX payment system. Field descriptions use "of the bank" phrasing that is inaccurate (e.g. pixKey, taxId belong to the account holder, not the bank). |
| openapi/paths/customers/customers_external_accounts.yaml | Example still uses "accountType: US_ACCOUNT" with "accountCategory: CHECKING" for creating external accounts, but US_ACCOUNT was removed from ExternalAccountType in this PR and the new UsdAccountInfo lacks the accountCategory field. Example is now invalid. |
| openapi/components/schemas/common/InrAccountInfo.yaml | New INR account schema using VPA (Virtual Payment Address). Field description "The VPA of the bank" is inaccurate - VPA belongs to the account holder, not the bank. |
| openapi/components/schemas/common/HkdAccountInfo.yaml | New HKD account schema. Field descriptions contain redundant phrasing: "The bank name of the bank" and "The account number of the bank". No validation patterns or examples provided. |
| openapi/paths/platform/platform_external_accounts.yaml | Example still references removed US_ACCOUNT type with accountCategory and bankName fields that no longer exist in UsdAccountInfo. Same issue as customers_external_accounts.yaml. |
Flowchart
flowchart TD
A[ExternalAccountCreateRequest] --> B[ExternalAccountInfoOneOf]
B --> C{accountType discriminator}
C --> D[BRL_ACCOUNT → BrlExternalAccountInfo]
C --> E[DKK_ACCOUNT → DkkExternalAccountInfo]
C --> F[GBP_ACCOUNT → GbpExternalAccountInfo]
C --> G[HKD_ACCOUNT → HkdExternalAccountInfo]
C --> H[IDR_ACCOUNT → IdrExternalAccountInfo]
C --> I[INR_ACCOUNT → InrExternalAccountInfo]
C --> J[MXN_ACCOUNT → MxnExternalAccountInfo]
C --> K[MYR_ACCOUNT → MyrExternalAccountInfo]
C --> L[PHP_ACCOUNT → PhpExternalAccountInfo]
C --> M[SGD_ACCOUNT → SgdExternalAccountInfo]
C --> N[THB_ACCOUNT → ThbExternalAccountInfo]
C --> O[USD_ACCOUNT → UsdExternalAccountInfo]
C --> P[VND_ACCOUNT → VndExternalAccountInfo]
C --> Q[SPARK_WALLET / LIGHTNING / etc.]
D --> R[BaseExternalAccountInfo + BrlAccountInfo]
O --> S[BaseExternalAccountInfo + UsdAccountInfo]
R --> T{beneficiary oneOf}
S --> T
T --> U[Individual: CurrencyBeneficiary]
T --> V[Business: BusinessBeneficiary]
style D fill:#f9f,stroke:#333
style O fill:#f9f,stroke:#333
style H fill:#ffa,stroke:#f00
style S fill:#ffa,stroke:#f00
Last reviewed commit: 2032fbc
Additional Comments (2)
This example still uses This example will now fail validation against the updated schema. It needs to be updated to use the new Prompt To Fix With AIThis is a comment left during a code review.
Path: openapi/paths/customers/customers_external_accounts.yaml
Line: 127:131
Comment:
**Stale example using removed account type**
This example still uses `accountType: US_ACCOUNT` with `accountCategory: CHECKING` and `bankName`, but this PR removes `US_ACCOUNT` from the `ExternalAccountType` enum and replaces it with `USD_ACCOUNT`. The new `UsdAccountInfo` schema does not include `accountCategory` or `bankName` fields.
This example will now fail validation against the updated schema. It needs to be updated to use the new `USD_ACCOUNT` type and only include the fields defined in `UsdAccountInfo` (`accountNumber`, `routingNumber`).
```suggestion
accountType: USD_ACCOUNT
accountNumber: "12345678901"
routingNumber: "123456789"
```
How can I resolve this? If you propose a fix, please make it concise.
Same issue as in Prompt To Fix With AIThis is a comment left during a code review.
Path: openapi/paths/platform/platform_external_accounts.yaml
Line: 89:93
Comment:
**Stale example using removed account type**
Same issue as in `customers_external_accounts.yaml`: this example uses `accountType: US_ACCOUNT` with `accountCategory: CHECKING` and `bankName`, but `US_ACCOUNT` is no longer a valid `ExternalAccountType` value in this PR, and the new `UsdAccountInfo` schema does not include `accountCategory` or `bankName`.
```suggestion
accountType: USD_ACCOUNT
accountNumber: "12345678901"
routingNumber: "123456789"
```
How can I resolve this? If you propose a fix, please make it concise. |
) ### TL;DR Extracted `CounterpartyInformation` into a separate reusable schema component. ### What changed? - Created a new schema component `CounterpartyInformation` that was previously defined inline - Updated references in the `Transaction` schema to use the new component via `$ref` - Applied these changes consistently across both the main OpenAPI file and the modular component files ### How to test? 1. Validate that the OpenAPI spec still compiles correctly 2. Verify that API documentation renders the `CounterpartyInformation` schema properly 3. Confirm that any endpoints using transactions with counterparty information still function as expected ### Why make this change? This refactoring improves the OpenAPI specification by: - Promoting reusability of the `CounterpartyInformation` schema - Making the schema more maintainable by defining it in a single location - Following best practices for OpenAPI schema organization - Ensuring consistency if this schema needs to be referenced from other components in the future
## Summary - New documentation page at **Get started > Overview > Building with AI** (before FAQ) - Helps developers use AI coding assistants (Claude Code, Cursor, Windsurf) with the Grid API - Covers: skill installation, credential setup, example prompts by use case, CLI command reference, llms.txt discovery, and tips for best results - Uses custom FeatureCard components with new Central Icons (magnifying-glass, prompt, arrow-path-right, bug, console-sparkle) ## Test plan - [x] Page renders at `/platform-overview/building-with-ai` - [x] Appears in sidebar under Overview, before FAQ - [x] Sidebar icon (console-sparkle) renders correctly - [x] FeatureCards display with colored icons - [x] Code blocks, tables, and Tip component render properly - [x] Internal links (`/llms.txt`, `/llms-full.txt`) work 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com> Co-authored-by: Jeremy Klein <jklein24@gmail.com> Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com>
more leftover from removing the retry quotes api
|
Too many files changed for review. ( |
No description provided.