docs: document ownershipType field for external accounts

[claude]

Summary

• Add documentation for the new ownershipType field on external accounts
• Field was added in feat: add optional ownershipType to external account schema #784 but docs were not updated
• Documents the two values: FIRST_PARTY (customer's own account) and THIRD_PARTY (another person's account)
• Includes example JSON showing usage

Test plan

• Ran make lint - passes with 0 errors
• Verified documentation renders correctly in the external accounts snippet

🤖 Generated with Claude Code

[vercel]

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

2 Skipped Deployments

Project	Deployment	Actions	Updated (UTC)
grid-flow-builder	Ignored		Aug 5, 2026 9:01am
grid-wallet-demo	Ignored		Aug 5, 2026 9:01am

[mintlify]

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

Project	Status	Preview	Updated (UTC)
Grid	🟢 Ready	View Preview	Aug 5, 2026, 9:02 AM

[greptile-apps]

Greptile Summary

The PR documents the optional external-account ownershipType field and its two supported values.

• Adds descriptions for FIRST_PARTY and THIRD_PARTY.
• Adds a third-party USD account request example and omission guidance.
• The new example omits beneficiary address data that the page identifies as required for US USD accounts.

Confidence Score: 4/5

The documentation should be corrected before merging so the new USD example includes the beneficiary address required by the same page.

The ownershipType values and placement match the API schema, but developers copying the new third-party USD example would omit fields that the documentation identifies as required for US beneficiaries.

Files Needing Attention: mintlify/snippets/external-accounts.mdx

Important Files Changed

Filename	Overview
mintlify/snippets/external-accounts.mdx	Adds ownership-type guidance, but the new USD example conflicts with the page's documented minimum beneficiary requirements.

Prompt To Fix All With AI

### Issue 1
mintlify/snippets/external-accounts.mdx:1914-1917
**USD beneficiary address omitted**

When a developer copies this `THIRD_PARTY` USD example, the request omits the beneficiary address that the same page identifies as required for US individual beneficiaries, causing the request to be under-specified for the documented compliance requirements.

```suggestion
    "beneficiary": {
      "beneficiaryType": "INDIVIDUAL",
      "fullName": "Jane Smith",
      "address": {
        "line1": "123 Main Street",
        "city": "San Francisco",
        "postalCode": "94105",
        "country": "US"
      }
    }
```

---

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

_{Reviews (1): Last reviewed commit: "docs: document ownershipType field for e..." | Re-trigger Greptile}

[greptile-apps]

USD beneficiary address omitted

When a developer copies this THIRD_PARTY USD example, the request omits the beneficiary address that the same page identifies as required for US individual beneficiaries, causing the request to be under-specified for the documented compliance requirements.

Suggested change

	"beneficiary": {
	"beneficiaryType": "INDIVIDUAL",
	"fullName": "Jane Smith"
	}
	"beneficiary": {
	"beneficiaryType": "INDIVIDUAL",
	"fullName": "Jane Smith",
	"address": {
	"line1": "123 Main Street",
	"city": "San Francisco",
	"postalCode": "94105",
	"country": "US"
	}
	}

Context Used: mintlify/AGENTS.md (source)

Knowledge Base Used: Mintlify Documentation Site

Prompt To Fix With AI

This is a comment left during a code review.
Path: mintlify/snippets/external-accounts.mdx
Line: 1914-1917

Comment:
**USD beneficiary address omitted**

When a developer copies this `THIRD_PARTY` USD example, the request omits the beneficiary address that the same page identifies as required for US individual beneficiaries, causing the request to be under-specified for the documented compliance requirements.

```suggestion
    "beneficiary": {
      "beneficiaryType": "INDIVIDUAL",
      "fullName": "Jane Smith",
      "address": {
        "line1": "123 Main Street",
        "city": "San Francisco",
        "postalCode": "94105",
        "country": "US"
      }
    }
```

**Context Used:** mintlify/AGENTS.md ([source](https://github.com/lightsparkdev/grid-api/blob/main/mintlify/AGENTS.md))

**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.

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!