Skip to content

docs(developers): list the Server's Apps (GET /api/oauth/apps, app:read) - #260

Merged
stamp-build[bot] merged 2 commits into
mainfrom
agent/app-list-api
Nov 14, 2026
Merged

stamp-build[bot] merged 2 commits into
mainfrom
agent/app-list-api

Conversation

@stamp-build

@stamp-build stamp-build Bot commented Nov 14, 2026

Copy link
Copy Markdown
Contributor

AppFather from raft opened this pull request through Stamp
View in Stamp →


Public docs for GET /api/oauth/apps and the app:read scope (#proj-apps:#43, slock #13343). Live in production since 1.27.0 (2026-11-13 18:05Z).

What

  • Login with Raft guide: new section "Listing the Server's Apps": declare and request app:read, the call and its answer, who may call it (people only, no Guests, no Agents), what is listed (installed + published on the public Marketplace + https homepage; never server-local, privately shared or unpublished Apps), field list, no-store.
  • The Server-scoped endpoints table gets the row; "three/four" endpoint count updated.
  • zh-cn mirror of both changes (Hasaki maintains zh-cn: please review or take over).

Checks

  • Checked against slock v1.27.0: packages/server/src/routes/oauth.ts (GET /apps: human tokens only, allowGuests: false, app:read, Cache-Control: no-store, entries without a public https homepage dropped, picture via publicHttpsUrl), oauthService.listOAuthAppDirectory (installed, humanMarketplaceVisible, published/unpublish_requested, ordered by name), shared/src/oauthScopes.ts (label "See which Apps the Server has installed"). Not advertised in discovery (no apps_endpoint), so the page doesn't mention one.
  • scripts/zh-cn/check.mjs: no errors on the changed page (the 11 errors it reports are on other pages, already on main).
  • Site not built here; anchors rely on CI's build.

Requirement Challenge

  • Cut: account-mode details (planned, not shipped for this endpoint's users); no separate page, one section next to the Agent directory.
  • Simplest version: one section + one table row.
  • Constraint owners: Tenny (protocol), Hasaki (zh-cn).

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Nov 14, 2026 •

Copy link
Copy Markdown

Deploying raft-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 91e5b8f
Status: ✅  Deploy successful!
Preview URL: https://b9bc1189.raft-docs.pages.dev
Branch Preview URL: https://agent-app-list-api.raft-docs.pages.dev

View logs

@stamp-build
stamp-build Bot merged commit f1f4949 into main Nov 14, 2026
7 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.

0 participants