Read an access request – GET /v1/access-requests/{requestId}

GET/v1/access-requests/{requestId}

betaauthenticatedworkspace

When to use

Check the status of a request you own or may review.

For agents

A resolved request records a successful access check at resolution time. Permissions can change afterward; always enforce current access.

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.accessRequests.get('task_abcdefghijklmnopqrstuvwx');

Response

json

{
  "data": {
    "id": "task_abcdefghijklmnopqrstuvwx",
    "resourceId": "dbas_abcdefghijklmnopqrstuvwx",
    "resourceType": "database",
    "principalType": "apiKey",
    "principalId": "apikey_example",
    "level": "read",
    "reason": "Read customer accounts for support.",
    "status": "pending",
    "createdAt": "2026-10-27T12:00:00.000Z",
    "expiresAt": "2026-11-03T12:00:00.000Z"
  }
}