CLI command

skarbiec request list

List the access requests the register holds, or only those in one state.

Invocation#

Shell
skarbiec request list [--state pending|approved|denied|withdrawn]

Purpose#

List the access requests the register holds, or only those in one state.

Required inputs and options#

  • No positional input. --state keeps the requests in that state. POST /v1/operator/requests takes state.

Output and state effects#

  • Prints one row per request: id, requested_at, state, kind, resource, action, agent, decider, dual_control and how many decisions it holds. Reads only.

Refusals#

  • A flag other than --state exits 2 (arguments-flag-unknown): a mistyped --state used to list every request. A register that cannot be read, is not JSON or holds no requests list is refused naming it (request-register-not-json, request-register-damaged).