Skip to content

Fix placeholder traffic-purchase endpoint in troubleshooting docs - #1207

Open
8bitpal wants to merge 2 commits into
mainfrom
content/fix-traffic-purchase-endpoint-1100
Open

Fix placeholder traffic-purchase endpoint in troubleshooting docs#1207
8bitpal wants to merge 2 commits into
mainfrom
content/fix-traffic-purchase-endpoint-1100

Conversation

@8bitpal

@8bitpal 8bitpal commented Aug 4, 2026

Copy link
Copy Markdown
Collaborator

Summary

Closes #1100.

POST /api/validator/v0/admin/traffic/purchase, used in three troubleshooting pages, does not exist in the validator OpenAPI spec (openapi/splice/validator/wallet-external.yaml). The real, documented endpoint for buying traffic is POST /v0/wallet/buy-traffic-requests (already covered on sdks-tools/api-reference/splice-validator-api.mdx).

  • docs-main/appdev/faq.mdx (2 occurrences)
  • docs-main/global-synchronizer/troubleshooting-guide/transaction-failures.mdx
  • docs-main/global-synchronizer/troubleshooting-guide/runbooks.mdx

Replaced the fabricated curl examples with the real endpoint and request body (per the OpenAPI schema), noted that it only creates the request (status must be polled via /v0/wallet/buy-traffic-requests/{tracking_id}/status), and linked to the "Buying Traffic" section of the validator API reference for the full schema.

POST /api/validator/v0/admin/traffic/purchase does not exist in the
validator OpenAPI spec. Replace it with the real
/v0/wallet/buy-traffic-requests endpoint across faq.mdx,
transaction-failures.mdx, and runbooks.mdx, and link to the API
reference for the full request/response schema.

Signed-off-by: 8bitpal <elias@zerolimit.es>
@mintlify

mintlify Bot commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
cantonfoundation 🟢 Ready View Preview Aug 4, 2026, 10:44 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@8bitpal 8bitpal changed the title Fix fabricated traffic-purchase endpoint in troubleshooting docs Fix placeholder traffic-purchase endpoint in troubleshooting docs Aug 4, 2026
@8bitpal
8bitpal marked this pull request as ready for review August 4, 2026 12:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Traffic purchase API endpoint not documented

1 participant