Skip to content

docs(ai-gateway): document the service-role-only gateway rule - #330

Merged
yardend-wix merged 3 commits into
mainfrom
docs/ai-gateway-service-role
Oct 14, 2026
Merged

yardend-wix merged 3 commits into
mainfrom
docs/ai-gateway-service-role

Conversation

@yardend-wix

@yardend-wix yardend-wix commented Oct 14, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

AI gateway requests must be made server-side with the app's service role (base44.asServiceRole.aiGateway.connection()). Calls from the browser or with a user's token get 403, error code ai_gateway_requires_service_role. The private/workspace user-token exception is a one-line note.

  • Authentication Modes: restated to the rule above.
  • AiGatewayConnection.token: no longer describes the empty unauthenticated token as a normal case.
  • Examples already use asServiceRole, unchanged.

Docs: I didn't run create-docs / push-docs. Published Mintlify already has #305's newer text, which main lacks, so a push from main would regress it. The same wording is applied by hand in base44-dev/mintlify-docs#2569.

Conflict note: #305 rewrites this section. Whichever lands second must keep the service-role paragraph.

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@github-actions

github-actions Bot commented Oct 14, 2026 •

Copy link
Copy Markdown

🚀 Package Preview Available!


Install this PR's preview build with npm:

npm i @base44-preview/sdk@0.8.53-pr.330.2d53a0c

Prefer not to change any import paths? Install using npm alias so your code still imports @base44/sdk:

npm i "@base44/sdk@npm:@base44-preview/sdk@0.8.53-pr.330.2d53a0c"

Or add it to your package.json dependencies:

{
  "dependencies": {
    "@base44/sdk": "npm:@base44-preview/sdk@0.8.53-pr.330.2d53a0c"
  }
}

Preview published to npm registry — try new features instantly!

@github-actions github-actions Bot added the docs-draft PR has auto-drafted documentation suggestions label Oct 14, 2026
yardend-wix and others added 2 commits October 14, 2026 11:51
…e role

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@yardend-wix
yardend-wix merged commit 8cc60ca into main Oct 14, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs-draft PR has auto-drafted documentation suggestions

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants