Apps · appsAccessGet

Get app access settings

Requires app read permission. Returns the current access mode and concurrency version, never a password or hash. Missing configuration defaults to Permute sign-in.

GET/v1/apps/{applicationId}/access

betaapiKeyworkspace

When to use

Read how visitors authenticate to an app.

For agents

Access settings are mutable and separate from app revisions. Retain the version for a conditional update; passwords and hashes are never returned.

Example

typescript

import { PermuteClient } from '@permute/sdk';

const orgClient = new PermuteClient({
  apiKey: process.env.PERMUTE_API_KEY!,
});

const client = orgClient.withWorkspace(process.env.PERMUTE_WORKSPACE_ID!);

const result = await client.apps.access('appl_abcdefghijklmnopqrstuvwx');

Response

json

{
  "data": {
    "mode": "permute",
    "version": 0,
    "canManage": true
  }
}