docs: clarify paid-plan requirement in API permission error message

[sinankeskin]

Matches the updated tnt-api error string for DEV-12132: read/write endpoints beyond POST /v2/tracking_requests now explain in the 401 response that a paid plan is required, with a link to the billing settings page.

---

^{Need help on this PR? Tag @codesmith-bot with what you need. Autofix is disabled.}

Greptile Summary

This PR synchronizes the documented restricted API-access error with the updated response, clarifying that permissions beyond creating tracking requests require a paid plan and directing users to billing settings.

• Updates the API introduction’s example 401 response.
• Updates the entitlements table with the same paid-plan guidance.

Confidence Score: 5/5

The documentation-only change appears safe to merge.

The two pages consistently apply the intended paid-plan clarification, and no changed-code-triggered build, rendering, security, or documentation-contract failure was established.

Important Files Changed

Filename	Overview
docs/api-docs/api-reference/introduction.mdx	Updates the documented free-plan permission error with paid-plan and billing guidance; no actionable regression identified.
docs/api-docs/useful-info/entitlements.mdx	Keeps the entitlement overview consistent with the revised permission-error wording; no actionable regression identified.

_{Reviews (1): Last reviewed commit: "docs: clarify paid-plan requirement in A..." | Re-trigger Greptile}

[mintlify]

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

Project	Status	Preview	Updated (UTC)
terminal49	🟢 Ready	View Preview	Aug 25, 2026, 8:32 PM

[linear-code]

DEV-12132

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
api	Ready	Preview	Aug 25, 2026 8:32pm