docs(authentication): simplify auth guide with API key vs Client ID methods and remove AI-generated content

[aimensahnoun]

TL;DR

Simplified the authentication documentation to focus on the two core authentication methods: API key and Client ID authentication.

What changed?

• Removed AI-generated content warning and extensive boilerplate sections
• Streamlined content to focus on API key (x-api-key) and Client ID (x-client-id) authentication methods
• Replaced lengthy step-by-step guides and accordion sections with concise examples and reference tables
• Updated description from generic "API authentication, key management, and security best practices" to specific "How to authenticate Request Network API calls with API keys or Client ID"
• Condensed error handling section to focus on the three main HTTP status codes (401, 403, 429)
• Simplified security guidance to essential best practices
• Updated related pages section to reference API Portal, Webhooks, and OpenAPI documentation

How to test?

• Verify that the cURL examples work correctly with valid API keys and Client IDs
• Test that the authentication headers are properly documented for both server-side and browser-based integrations
• Confirm that links to related documentation pages are functional

Why make this change?

The original documentation was verbose and contained AI-generated disclaimers that reduced confidence in the content. This revision provides developers with clear, actionable authentication instructions without unnecessary complexity, making it easier to quickly understand and implement the two supported authentication methods.

[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(authentication): simplify auth guide with API key vs Client ID methods and remove AI-generated content #70 👈 (View in Graphite)
• 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

Successfully simplified authentication documentation by removing AI-generated disclaimers and verbose content. The rewrite focuses clearly on two core authentication methods (x-api-key and x-client-id) with concise examples and proper error documentation.

Key improvements:

• Removed 151 lines of verbose/redundant content while preserving all critical information
• Clear comparison table helps developers choose the right auth method
• cURL examples match patterns used throughout the codebase
• Security guidance is actionable and focused on essentials
• All internal links verified (related pages exist and are properly structured)
• Follows Mintlify technical writing guidelines from AGENTS.md

Confidence Score: 5/5

• This PR is safe to merge with minimal risk
• Documentation-only change that improves clarity without introducing technical errors. All authentication patterns verified against existing codebase usage, internal links confirmed valid, and structure follows established guidelines
• No files require special attention

Important Files Changed

Filename	Overview
api-reference/authentication.mdx	Simplified authentication doc with accurate API key and Client ID methods, proper examples, and clean structure

_{Last reviewed commit: af3e6cc}

[greptile-apps]

_{1 file reviewed, no comments}

_{Edit Code Review Agent Settings | Greptile}