permission-requests

Get a tool-approval request

Fetch a single approval request by id, scoped to the caller's tenant. Argument values are sanitized and visible only to callers who can decide requests (runs:execute) and are rendered in FULL on this detail view, so an approver can review everything the tool will run with; read-only callers receive a value-free input_summary instead.

get/v1/permission-requests/{permission_request_id}

Request

  • Base URL: https://api.patricia.app (the document declares no server; this is the origin it was published from)
  • URL: https://api.patricia.app/v1/permission-requests/{permission_request_id}
  • Auth: HTTP bearer

Path parameters

permission_request_idstring uuid required

Headers

X-Tenant-Idstring nullable

Response

Successful Response

idstring uuid nullable
run_idstring uuid nullable
tool_namestring nullable
risk_tier_codestring nullable
status_codestring nullable
can_approveboolean
can_denyboolean
dispatch_blockedboolean

True when the bound account is personal and the run's actor is not its connector, so an approval would be refused. Deliberately separate from can_approve, which keeps its own meaning: whether this caller holds approval authority under the audience policy.

dispatch_block_reasonstring nullable

Machine-readable code naming why dispatch is blocked, or null when it is not.

inputobject nullable

Tool arguments, sanitized. Present only for callers holding runs:execute (the authority that can decide this request); null for read-only callers, which receive input_summary instead. Null with no input_summary means the request carries no stored arguments.

repeat_coverage_announcedboolean nullable
task_offer_manifestobject nullable
task_offer_manifest_digeststring nullable
delivery_refstring nullable
approver_actor_idstring uuid nullable
expires_atstring date-time nullable
resolved_atstring date-time nullable
created_atstring date-time nullable

Changes

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