Installed Apps

Install App

PREVIEW. This endpoint is deployed but gated: it returns 404 unless the hosted app platform is enabled for your organization. It is published here so the contract describes the whole surface, not so it can be called today.

Install an app into your workspace and grant it scopes.

Consent is recorded immediately — there is no pending step in the beta, and a pending status that nothing ever advanced would be a trap. Re-installing an app you already have UPDATES the grant in place, which is how you change scopes; there is exactly one install row per (app, workspace).

post/installed-apps

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/installed-apps
  • Auth: HTTP bearer

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

app_idstring required

The app to install, e.g. dapp_a1b2c3d4e5f6.

scopesstring[]

Scopes you grant the app, e.g. objects:read. Only scopes the platform enables for apps are accepted; anything else is rejected rather than silently dropped, so a granted scope always means what it says.

Response

Successful Response

Changes

No recorded changes to this operation across all 2 revisions of this API.