Cloudflare announced that its API 403 Forbidden responses have been enriched with a documentation_url field. When a request is denied, the error payload now includes a direct link to the documentation for the specific endpoint that was blocked.
What the response looks like:
{
"success": false,
"errors": [
{
"code": 10000,
"message": "Forbidden",
"documentation_url": "https://developers.cloudflare.com/api/resources/workers/subresources/beta/subresources/workers/methods/list"
}
],
"messages": [],
"result": null
}
This addition is a vendor claim from Cloudflare, aimed at speeding up troubleshooting by surfacing the roles and permissions required for the denied endpoint. It also enables automation tools and support agents to fetch the relevant docs programmatically, potentially feeding into approval workflows.
According to the changelog, the feature is now available across “nearly all Cloudflare product APIs,” making it a broad improvement for developers, administrators, and third‑party tools that interact with Cloudflare’s services.
For more details, see the official Cloudflare changelog post.