List remembered tool-approval grants

GET

/v1/tool-approval-grants

GET

/v1/tool-approval-grants

$ curl https://api.runtype.com/v1/tool-approval-grants \
>      -H "Authorization: <apiKey>" \
>      -H "Content-Type: application/json"

1 {
2   "data": [
3     {
4       "agentId": "agent_9f8b7c6d",
5       "createdAt": "2024-06-10T09:15:30Z",
6       "decision": "always_allow",
7       "endUserRef": null,
8       "expiresAt": null,
9       "id": "grant_123e4567-e89b-12d3-a456-426614174000",
10       "sourceApprovalId": null,
11       "sourceExecutionId": null,
12       "toolName": "DataCleaner Pro",
13       "toolType": "automation_script"
14     },
15     {
16       "agentId": "agent_4a3b2c1d",
17       "createdAt": "2024-05-22T14:45:00Z",
18       "decision": "always_allow",
19       "endUserRef": "user_789xyz",
20       "expiresAt": "2024-12-31T23:59:59Z",
21       "id": "grant_987f6543-e21b-45d3-b789-123456789abc",
22       "sourceApprovalId": "approval_456def",
23       "sourceExecutionId": "exec_789ghi",
24       "toolName": "ImageOptimizer",
25       "toolType": "plugin"
26     }
27   ]
28 }

List the authenticated owner’s active cross-session “Always allow” grants. Optionally filter to a single agent with ?agentId=. A null endUserRef is an account-level grant.

Authentication

AuthorizationBearer

API key or Clerk session token

Query parameters

agentIdstringOptional

Response

Active grants

datalist of objects

Errors

401

Unauthorized Error