PermuteDocs
Go to Permute

Apps · appsGrantsList

List app resource grants

Lists the app’s current resource grants, including explicit operations. For legacy concrete actions, resolves effective operations against current and app-pinned execution requirements when the caller can inspect them; reading does not rewrite the grant. Requires app read permission. Grants limit access; users still need their own permissions. Action invocation additionally requires a revision binding; sources use current grants without bindings.

GET/v1/apps/{applicationId}/grants
betaapiKeyworkspace

When to use

Inspect the app’s current resource access ceiling.

For agents

Grants are independent of app revisions. Source reads require current app and viewer read permission, without source revision bindings. Action calls also require an exact action revision pin in the served app release.

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.listGrants('appl_abcdefghijklmnopqrstuvwx');

Response

json
{
  "data": {
    "items": [
      {
        "resourceId": "actn_abcdefghijklmnopqrstuvwx",
        "resourceType": "businessAction",
        "level": "write",
        "expiresAt": null
      }
    ],
    "canManage": true
  }
}