List access requests for an agent

GET /v1/agents/{agentId}/access/requests

List access requests for an agent

cURL

curl --request GET \
  --url https://{host}/v2/workspaces/slug:agent-factory/webhooks/v1/agents/{agentId}/access/requests \
  --header 'Authorization: Bearer <token>'

200

{
  "items": [
    {
      "_id": "<string>",
      "agent_id": "<string>",
      "requester_id": "<string>",
      "requester_email": "<string>",
      "orgSlug": "<string>",
      "message": "<string>",
      "resolved_by": "<string>",
      "rejection_reason": "<string>"
    }
  ],
  "total": 123,
  "page": 123,
  "limit": 123
}

Authorizations

BearerAuthOrgApiKeyAuth

Authorization · string · header · required

User-bound credential carrying an identity: either a session JWT or a user access token (at:*) generated from the user settings UI. Send as Authorization: Bearer <token>. Org API keys (iak_*) are not accepted here - they carry no user identity. Use the x-prismeai-api-key header instead (see OrgApiKeyAuth).

Path Parameters

agentId · string · required

Maximum string length: 64

Query Parameters

status · enum<string>

Available options: pending, approved, rejected

Maximum string length: 32

limit · string

Page size (default 100).

page · string

Response

200

application/json

Page of access requests.

items · object[]

Hide child attributes

items. _id · string

items. agent_id · string

items. requester_id · string

items. requester_email · string

items. orgSlug · string

items. status · enum<string>

Available options: pending, approved, rejected

items. message · string

items. resolved_by · string

items. rejection_reason · string

total · integer

page · integer

limit · integer