Skip to content

docs(platform): socket sessions move to /api/v1 and take a personal access token - #341

Merged
ozsay merged 1 commit into
mainfrom
ozs/platform-socket-sessions-pat
Oct 19, 2026
Merged

ozsay merged 1 commit into
mainfrom
ozs/platform-socket-sessions-pat

Conversation

@ozsay

@ozsay ozsay commented Oct 19, 2026

Copy link
Copy Markdown
Contributor

Summary

The Platform SDK README described the white-label socket-session API at its old path and as workspace-key only. base44-dev/apper#31673 moves it and adds personal access tokens:

  • POST /api/service/socket-sessions → POST /api/v1/socket-sessions
  • PUT/DELETE …/{session_id}/rooms/{app_id} → …/{session_id}/apps/{app_id}
  • Your backend can authenticate with a personal access token (the apps its owner can edit) or a workspace API key with apps:watch, both as Authorization: Bearer. The workspace needs the Builder plan or higher.

No code change: the client only reads the session body (session_token, socket_url, socket_path), which is unchanged. asyncapi.json picks up the new wording through the hourly sync.

Merge order

Merge after base44-dev/apper#31673 is deployed, since until then the new path doesn't exist.

🤖 Generated with Claude Code

@github-actions

github-actions Bot commented Oct 19, 2026 •

Copy link
Copy Markdown
Contributor

🚀 Package Preview Available!


Install this PR's preview build with npm:

npm i @base44-preview/sdk@0.8.54-pr.341.64849bb

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.54-pr.341.64849bb"

Or add it to your package.json dependencies:

{
  "dependencies": {
    "@base44/sdk": "npm:@base44-preview/sdk@0.8.54-pr.341.64849bb"
  }
}

Preview published to npm registry — try new features instantly!

@github-actions

github-actions Bot commented Oct 19, 2026 •

Copy link
Copy Markdown
Contributor

🚀 Package Preview Available! (@base44/platform)


Install this PR's preview build with npm:

npm i @base44-preview/platform@0.3.0-pr.341.64849bb

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

npm i "@base44/platform@npm:@base44-preview/platform@0.3.0-pr.341.64849bb"

Or add it to your package.json dependencies:

{
  "dependencies": {
    "@base44/platform": "npm:@base44-preview/platform@0.3.0-pr.341.64849bb"
  }
}

Preview published to npm registry — try new features instantly!

…ccess token

Your backend opens a session at POST /api/v1/socket-sessions with a personal
access token or a workspace key (apps:watch), and manages its apps at
/{session_id}/apps/{app_id}. No code change: the client only reads the
session body.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@ozsay
ozsay force-pushed the ozs/platform-socket-sessions-pat branch from 58f6d1f to 482eaf7 Compare October 19, 2026 14:41
@ozsay
ozsay marked this pull request as ready for review October 19, 2026 14:42
@ozsay
ozsay merged commit a66be5a into main Oct 19, 2026
8 checks passed
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.

2 participants