Agents

Poll an approval

Reports where an approval stands, so an agent holding an approval_required response can wait for the sponsor's decision and retry. Only the agent the approval belongs to can read it.

get/v1/agent-approvals/{approvalId}

Request

  • Base URL: https://api.prisma.io
  • URL: https://api.prisma.io/v1/agent-approvals/{approvalId}
  • Auth: one of:
    • OAuth 2 (authorization code, authorization URL https://auth.prisma.io/authorize, token URL https://auth.prisma.io/token, scopes: workspace:admin, offline_access)
    • HTTP bearer

Path parameters

approvalIdstring required

Response

The approval's current state

idstring required
status'pending' | 'approved' | 'approved_window' | 'denied' | 'expired' | 'consumed' required
expiresAtstring required
windowExpiresAtstring nullable required
decidedAtstring nullable required
hintstring

Changes

No recorded changes to this operation across all 1 revision of this API.