Skip to content

jitsudo status

Check the status of an elevation request, or list multiple requests.

jitsudo status [request-id] [flags]

Without arguments, jitsudo status lists requests according to the supplied filter flags. With a request ID argument it prints the full details of that single request.

FlagDescription
--mineList all requests submitted by the currently authenticated user
--pendingList all requests in PENDING state (for approvers)
FlagDefaultDescription
--server <url>Stored credentialsControl plane URL
--token <token>Stored credentialsBearer token override
-o, --output <format>tableOutput format: table, json, yaml
-q, --quietfalseSuppress non-essential output
--debugfalseEnable debug logging
Terminal window
# Get the full details of a specific request
jitsudo status req_01J8KZ4F2EMNQZ3V7XKQYBD4W
# List all your own requests
jitsudo status --mine
# List all pending requests (approver workflow)
jitsudo status --pending
# Get a request in JSON format
jitsudo status req_01J8KZ4F2EMNQZ3V7XKQYBD4W --output json
ID: req_01J8KZ4F2EMNQZ3V7XKQYBD4W
State: ACTIVE
Requester: alice@example.com
Provider: aws
Role: prod-infra-admin
Scope: 123456789012
Duration: 2h0m0s
Reason: Investigating P1 ECS crash — INC-4421
Approver: bob@example.com
Comment: Approved for INC-4421 response
Expires: 2026-03-20T18:00:00Z
ID STATE REQUESTER REASON
---------------------------------------------------------------------------------
req_01J8KZ4F2EMNQZ3V7XK... ACTIVE alice@example.com Investigating P1 ECS crash
req_01J8KZ5HMNPQS4X8... PENDING carol@example.com Deploy hotfix to staging
StateDescription
PENDINGSubmitted, waiting for approver action
APPROVEDApproved by an approver; credentials not yet fetched
REJECTEDDenied by an approver
ACTIVECredentials have been issued and are in use
EXPIREDElevation window elapsed; credentials automatically revoked
REVOKEDManually revoked before expiry via jitsudo revoke

Once a request reaches ACTIVE state:

  • Run jitsudo exec <request-id> -- <command> to execute a single command with elevated credentials.
  • Run jitsudo shell <request-id> to open an interactive elevated shell.
  • Run jitsudo revoke <request-id> to end the elevation early.