chore: update v3 OpenAPI specs to v3.662.0

[Ed Fricker (beastawakens)]

User description

Automated v3 OpenAPI spec update for v3.662.0.

Triggered by Ope (@okufoniyi) - assigned to you in case it needs a manual merge.

---

PR Type

enhancement

---

Description

• Update API endpoint paths to use underscores instead of hyphens

• Remove hardcoded server URLs from services and fraud specs

• Change Smart Selfie Compare path from /v3/smart_selfie_compare to /v3/compare

• Add changelog entry for v3.662.0

---

Diagram Walkthrough

flowchart LR
  A["Path updates"] -- "hyphens to underscores" --> B["document_verification"]
  A -- "hyphens to underscores" --> C["enhanced_document_verification"]
  A -- "renamed" --> D["/v3/compare"]
  E["Server blocks"] -- "removed" --> F["v3-services.yaml"]
  E -- "removed" --> G["v3-report-user-fraud.yaml"]

Loading

File Walkthrough

	Relevant files
Documentation	2 files CHANGELOG.md Add v3.662.0 release changelog entry                                          +10/-0    README.md Update endpoint paths in spec table                                            +3/-3
Enhancement	3 files v3-document-verification-entry.yaml Change path from hyphenated to underscored                              +1/-1      v3-enhanced-document-verification-entry.yaml Change path from hyphenated to underscored                              +1/-1      v3-smart-selfie-compare-entry.yaml Rename endpoint path to `/v3/compare`                                        +1/-1
Configuration changes	2 files v3-report-user-fraud.yaml Remove hardcoded server URLs block                                              +0/-8      v3-services.yaml Remove hardcoded server URLs block                                              +0/-8

---

---

Need help?

Type /help how to ... in the comments thread for any questions about PR-Agent usage.

Check out the documentation for more information.

[prfectionist]

PR Reviewer Guide 🔍

Here are some key observations to aid the review process:

⏱️ Estimated effort to review: 1 🔵⚪⚪⚪⚪

🏅 Score: 90

🧪 No relevant tests

🔒 No security concerns identified

🔀 No multiple PR themes

⚡ Recommended focus areas for review Breaking Change The path changed from /v3/smart_selfie_compare to /v3/compare which is a more significant rename than the other changes (which just switched hyphens to underscores). This could be a breaking change for API consumers who are using the old path. Verify this is intentional and that proper deprecation/migration guidance exists. /v3/compare: Missing Servers The servers block was removed from this spec. If these specs are consumed independently (not bundled into a larger spec that provides server URLs), clients won't know which base URL to use. Verify that server URLs are provided at a higher level or that consumers don't rely on them being in individual spec files.

[prfectionist]

PR Code Suggestions ✨

No code suggestions found for the PR.

[Copilot]

Pull request overview

Automated update of the v3 OpenAPI spec set to v3.662.0, aligning documented endpoint paths and top-level spec metadata to match the latest API surface (and keeping the repo’s reference docs consistent for GitHub Pages / Postman import use).

Changes:

• Renamed several v3 endpoint paths to use underscores instead of hyphens (document verification specs).
• Renamed Smart Selfie Compare endpoint path to POST /v3/compare.
• Removed hardcoded servers blocks from the Services and Report User Fraud specs, and added a v3.662.0 changelog entry.

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
specs/v3/v3-smart-selfie-compare-entry.yaml	Updates the documented path to /v3/compare for Smart Selfie Compare.
specs/v3/v3-document-verification-entry.yaml	Switches the documented path to underscore form (/v3/document_verification).
specs/v3/v3-enhanced-document-verification-entry.yaml	Switches the documented path to underscore form (/v3/enhanced_document_verification).
specs/v3/v3-services.yaml	Removes hardcoded server URLs from the Services spec.
specs/v3/v3-report-user-fraud.yaml	Removes hardcoded server URLs from the Report User Fraud spec.
README.md	Updates the endpoint/spec table to reflect the renamed paths.
CHANGELOG.md	Adds the v3.662.0 release entry describing the updated specs.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Ed Fricker (beastawakens)]

Ope (@okufoniyi) Auto-merge couldn't complete after retries - please review and merge this PR manually.

[Ope (okufoniyi)]

LGTM