docs(api-reference): add v2 endpoints overview and switch docs OpenAPI to v2-only spec Improve API Reference navigation by introducing a dedicated Endpoints Overview page in docs and wiring Mintlify OpenAPI rendering to a local v2-only spec. - add `api-re

[aimensahnoun]

No description provided.

[aimensahnoun]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• docs: remove beta banner and legacy SDK tab #78
• Remove AI-generated content warnings and update internal links #77
• docs(lifecycle): replace external image with local asset and remove AI-generated warning #76
• docs: remove AI-generated content warnings and simplify Request Scan page #75
• docs(resources): remove community page from navigation #74
• docs(supported-chains): add Tron network support and enhance currency documentation #73
• docs(supported-chains): streamline supported chains and currencies documentation #72
• docs(api-reference): add v2 endpoints overview and switch docs OpenAPI to v2-only spec Improve API Reference navigation by introducing a dedicated Endpoints Overview page in docs and wiring Mintlify OpenAPI rendering to a local v2-only spec. - add `api-re #71 👈 (View in Graphite)
• docs(authentication): simplify auth guide with API key vs Client ID methods and remove AI-generated content #70
• docs(fee-breakdowns): rewrite to focus on API response locations and reconciliation usage #69
• docs(protocol-fees): add protocol fees documentation and navigation #68
• docs(platform-fees): simplify configuration guide and remove AI-generated content warning #67
• docs(query-payments): rewrite with practical implementation focus and remove AI warning #66
• docs(query-requests): simplify and refactor query requests documentation for practical implementation #65
• docs(payment-detection): simplify content and remove AI warning #64
• docs(partial-payments): rewrite with step-by-step implementation guide and clarify API usage #63
• docs(standard-payments): remove AI warning, restructure content with step-by-step flow, and update API references #62
• docs(conversion-payments): rewrite with step-by-step implementation guide and remove AI-generated warning #61
• docs(payment-types): simplify overview and add payment type selection guidance #60
• docs(crypto-to-fiat): expand comprehensive guide with sandbox access, compliance flows, and implementation details #59
• docs(recurring-payments): rewrite with comprehensive workflow, security details, and practical implementation guide #58
• docs(batch-payments): add comprehensive implementation guide with examples, workflow diagrams, and demo videos #57
• docs(crosschain-payments): replace AI-generated content with comprehensive implementation guide #56
• docs(create-requests): rewrite with workflows, examples, and remove AI warning #55
• feat: add complete integration tutorial with Node.js backend and React frontend #54
• docs(getting-started): remove AI warning and refactor to focus on practical payment integration #53
• docs(api-portal): remove AI warning, add local screenshot, and update .gitignore #52
• docs: remove release notes section and streamline use cases to core features #51
• main

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

[greptile-apps]

Greptile Summary

This PR introduces a dedicated Endpoints Overview page (api-reference/endpoints-overview.mdx) for the v2 API reference and switches the Mintlify OpenAPI rendering to a locally committed api-reference/openapi.v2.json spec. The docs.json navigation is updated to reference the v2-only scope.

Key changes:

• New api-reference/endpoints-overview.mdx with <CardGroup> cards for v2 endpoint groups and quick-links to frequently used endpoints.
• docs.json group renamed from "Endpoints" to "Endpoints (V2)", OpenAPI source switched from remote URL to local api-reference/openapi.v2.json.
• request-network-api/create-and-pay-requests.mdx — formerly the overview page — has been replaced with "Endpoints Overview" content and is now orphaned (not in navigation).

Issues found:

• Three of the four <Card> links in the overview (Payouts, Payments, Payer / Compliance) point to /api-reference/endpoints, which does not exist and will 404 for users.
• request-network-api/create-and-pay-requests.mdx is an orphaned file with duplicate content that should be deleted rather than left unmaintained in the repository.

Confidence Score: 2/5

• Not safe to merge — two critical issues must be resolved: broken card links and an orphaned file.
• The docs.json and openapi.v2.json changes are clean and well-structured, but the new endpoints overview page has three card links pointing to a non-existent route (/api-reference/endpoints), which will produce 404 errors for users. Additionally, an orphaned file (request-network-api/create-and-pay-requests.mdx) with misleading duplicate content should be deleted. Both issues must be addressed before merge.
• • api-reference/endpoints-overview.mdx (broken card hrefs at lines 17–27)
• request-network-api/create-and-pay-requests.mdx (orphaned file that should be deleted)

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A["docs.json\n(navigation config)"]
    A -->|"openapi: api-reference/openapi.v2.json"| B["openapi.v2.json\n(local v2-only spec)"]
    A -->|"pages: api-reference/endpoints-overview"| C["endpoints-overview.mdx\n(overview page)"]

    C -->|"✅ Requests card"| D["/api-reference/request/create-a-new-request-1"]
    C -->|"❌ Payouts card (404)"| E["/api-reference/endpoints\n(does not exist)"]
    C -->|"❌ Payments card (404)"| E
    C -->|"❌ Payer card (404)"| E

    B -->|"Mintlify auto-generates"| F["V2 Endpoint Pages\n(/api-reference/v2request/...\n/api-reference/v2payouts/...\netc.)"]

    G["request-network-api/create-and-pay-requests.mdx\n(orphaned — not in docs.json)"]
    G -.->|"no longer linked"| X["❌ unreachable in nav"]

Loading

_{Last reviewed commit: 0d66aac}

[greptile-apps]

_{4 files reviewed, 2 comments}

_{Edit Code Review Agent Settings | Greptile}

[greptile-apps]

Three of the four <Card> components in this CardGroup link to /api-reference/endpoints, which is not a real page in the navigation. Users clicking on "Payouts", "Payments", or "Payer / Compliance" will hit a 404.

These should link to actual pages once the OpenAPI spec is rendered by Mintlify and the endpoint pages are auto-generated. For now, either:

1. Remove the href attribute from these cards so they don't link anywhere, or
2. Link to the external OpenAPI docs (e.g., https://api.request.network/open-api/#tag/v2payouts) as done in the list sections below.

[greptile-apps]

Additional Comments (1)

request-network-api/create-and-pay-requests.mdx
This file is orphaned — it is no longer referenced in docs.json navigation and is unreachable to users. It contains a duplicate "Endpoints Overview" that mirrors api-reference/endpoints-overview.mdx.

Orphaned files should be deleted rather than left in the repository. If the original "Create and Pay Requests" content is no longer needed, remove this file entirely. If it should be restored, update docs.json to reference it again and restore the original content.